PERKIN-ELMER 


OS/32 SUPERVISOR CALL (SVC) 


Reference Manual 


48-038 FOO RO1 


Fhe information in this documerit is subject to change without notice and should not be 
construed as a commitment By the Perkin-Elmer Corporation. The Perkin-Elmér Cdrpo- 
ration assumes mo responsibility for any errars that may appear ift this documerit. 


The software described ir: this document is furnished under a licerise, and it cant be used or 
copied only in a manner permitted by that ficerise. Any copy of the described software 
must include the Perkin-Elmer copyright notice. Title to and ownership of the described 
software and afty copies thereof shall remain itt The Perkin-Elmer Corporation. 


The Perkin-Elmer Corporation assumes no responsibility for thé use or reliability df its 
software on equipment that is not supplied by Perkin-Elmer. 


The Perkin-Elmer Corporation, Data Systeris Group, 2 Crescent Place, Oceanport, New Jersey 07757 


© 1981, 1982, 1983 by The Perkin-Elmer Corporation 


Printed in the United States of America 


PREFACE 


CHAPTERS 


TABLE OF CONTENTS 


1 SUPERVISOR CALLS (SVCs) 


INTRODUCTION 
The Supervisor Call (SVC) Parameter Block 


SUPERVISOR CALL (SVC) ERRORS 
Supervisor Call (SVC) Error Messages 
Supervisor Call (SVC) Status Codes 


2 INPUT/OUTPUT (I/0) REQUEST SUPERVISOR CALL 1 (SVC 1) 


MMMM NNHNMNN NH MN DH HH NN ND FE 


e 


MM NNYNHMNNMNMNHNHNNMNNMNM NHN ND lo 


* 


SNNNO OP WM DY HRP PRP RPP ee 
te 


NOOO P WDM 


iJ 


. 


WN FE 


WNHE 


INTRODUCTION 

SUPERVISOR CALL 1 (SVC 1) 

Data Transfer Requests 

Test and Set 

Input/Output (1/0) Proceed 

Queuing Input/Output (1/0) Requests 
Conditional Proceed 

Unconditional Proceed 

Wait Input/Output (1/0) 

Wait Only 

Command Function Requests 

Halt Input/Output (1/0) 

Logical Unit (lu) 

Device Independent Status 

Device Dependent Status 

Buffer Start/Buffer End Address 
Extended Options 
Nonmagnetic Tape Devices 
Magnetic Tape Devices 
Device Dependent Status 
Tape Operations 


Codes for Magnetic 


GAPLESS INPUT/OUTPUT (I/0) OPERATIONS 
Gapless Mode SVC 1 Parameter Block Format 
Standard Function Code Format - Gapless Mode 
Logical Unit (lu) 


48-038 FOO ROL 


X1 


eee ee 


CHAPTERS (Continued) 


M2 Nh fh fo fo 


hh Po 


WWWWW 


WW WwW 
wo ~] 


NAAN |S 


Device Independent Status Codes 

Device Dependent Status Codes 

Buffer Queues 

Using the Buffer Queue 

Trap-Causing Events Resulting from Gapless 
Input/Output (1/0) Operations 

Buffer Length 

Length of Last Buffer 

Extended Options Field 


3 GENERAL SERVICE FUNCTIONS SUPERVISOR CALL 2 (SVC 2) 


3 


Ss 


Go 


QW W& 


WWW WwW Ww 


ii 


WWW W WW Ww ww 


1 


2 


WWW 


~] 


wWwwwwo wo 
Pm WN 


SNS 
PWN 


COMM M HOO OO 
OYUNMHHPRWNH 


INTRODUCTION 


SVC 2 CODE 1: PAUSE 


SVC 2 CODE 2: GET STORAGE 
SVC 2 Code 2, Option X'OO' 
SVC 2 Code 2, Option X'80' 


SVC 2 CODE 3: RELEASE STORAGE 


SVC 2 CODE 4: SET STATUS 
SVC 2 Code 4, Option X'O00' 
SVC 2 Code 4, Option X'‘'80' 


SVC 2 CODE 5: FETCH POINTER 


SVC 2 CODE 6: CONVERT BINARY NUMBER TO ASCII 
HEXADECIMAL OR ASCII DECIMAL 


SVC 2 Code 6, Option X'OO'tn 
SVC 2 Code 6, Option X'40'+tn 
SVC 2 Code 6, Option X'80'tn 
SVC 2 Code 6, Option X'CO'+tn 
SVC 2 CODE 7: LOG MESSAGE 
SVC 2 Code 7, Option xX'OO' 
SVC 2 Code 7, Option X'20' 
SVC 2 Code 7, Option X'40' 
SVC 2 Code 7, Option X'60' 
SVC 2 Code 7, Option X'80' 
SVC 2 Code 7, Option X'AO' 
SVC 2 Code 7, Option X'CO' 
SVC 2 Code 7, Option X'EO' 
SVC 2 CODE 8: INTERROGATE CLOCK 
SVC 2 Code 8, Option X'OO0' 
SVC 2 Code 8, Option X'80' 
SVC 2 Code 8, Option X'40' 
SVC 2 Code 8, Option X'CO' 


48-038 


FOO ROL 


CHAPTERS (Continued) 


3.10 SVC 2 CODE 9: FETCH DATE 
3.11 SVC 2 CODE 10: TIME OF DAY WAIT 
3.12 SVC 2 CODE 11: INTERVAL WAIT 
oo eh We | SVC 2 CODE 15: CONVERT ASCII HEXADECIMAL 
OR ASCII DECIMAL TO BINARY 
Se lock SVC 2 Code 15, Option xX'OO' 
3243.2 SVC 2 Code 15, Option X'40' 
3213.3 SVC 2 Code 15, Option X'80' 
3.13.4 SVC 2 Code 15, Option X'CO' 
3.14 SVC 2 CODE 16: PACK FILE DESCRIPTOR 
3514. 1 SVC 2 Code 16, Option X'00' 
3.14.2 SVC 2 Code 16, Option X'40' 
3.14.3 SVC 2 Code 16, Option X'10' 
3.14.4 SVC 2 Code 16, Option X'50' 
3.14.5 SVC 2 Code 16, Option X'20' 
3.14.6 SVC 2 Code 16, Option X'60' 
3.14.7 SVC 2 Code 16, Option X'80' 
3.14.8 SVC 2 Code 16, Option X'CO' 
3.14.9 SVC 2 Code 16 Options for Privileged Tasks 
3.15 SVC 2 CODE 17: SCAN MNEMONIC TABLE 
es ce & Building a Mnemonic Table 
3:15.22 Executing SVC 2 Code 17 
3.16 SVC 2 CODE 18: MOVE ASCII CHARACTERS 
32 bb... SVC 2 Code 18, Option X'OO'tn 
3.16.2 SVC 2 Code 18, Option X'80'+tn 
Biche SVC 2 CODE 19: PEEK 
32:h751 Parameter Block for Option X'OO' 
ec ee Bf ree Parameter Block for Option X'Ol1' 
SeL7 23 Parameter Block for Option X'02' 
3.17.4 Parameter Block for Option X'03' 
317.5 Parameter Block for Option X'04' 
3.18 SVC 2 CODE 20: EXPAND ALLOCATION 
3.19 SVC 2 CODE 21: CONTRACT AI.LOCATION 
3.20 SVC 2 CODE 23: TIMER MANAGEMENT 
3.20.1 SVC 2 Code 23 Parameter Block for Option X'O0' 
3 220'52 SVC 2 Code 23 Parameter Block for Option X'80O' 
3420.43 SVC 2 Code 23 Parameter Block for Option xX'40' 
3.20.4 SVC 2 Code 23 Parameter Block for Option X‘'20' 
3.20.5 SVC 2 Code 23 Parameter Block for Option X'10' 
3.21 SVC 2 CODE 24: SET ACCOUNTING INFORMATION 


48-038 FOO ROL 


iii 


= ee oe 


CHAPTERS (Continued) 


lv 


3.22 SVC 2 CODE 25: FETCH ACCOUNTING INFORMATION 


3.23 SVC 2 CODE 29: UNPACK FILE DESCRIPTOR 


END OF TASK SUPERVISOR CALL 3 (SVC 3) 
4.1 INTRODUCTION 


4.2 SVC 3: END OF TASK 


FETCH OVERILAY SUPERVISOR CALL 5 (SVC 5) 
5.1 INTRODUCTION 


5.2 SVC 5: FETCH OVERLAY 


INTERTASK COMMUNICATIONS SUPERVISOR CALL 6 (SVC 6) 


6.1 INTRODUCTION 

6.2 SVC 6: INTERTASK COMMUNICATIONS 
6.2.1 Function Code (SVC6.FUN) 

B27 22 Direction (SFUN.DOM,SFUN.DSM) 

6.2.3 End Task (SFUN.ECM,SFUN.EDM) 

6.2.4 Load Task Functions 

6.2.4.1 Load Task (SFUN.LM) 

6.2.4.2 Load Task with Extended Load Options 


(SFUN.L.XM) 


6.225 Task Resident (SFUN.HM) 

6.2.6 Suspend (SFUN.SM) 

6.2.7 Send Data (SFUN.DB) 

6.2.7.1 Send Data Message Buffer for Sending Task 

6.2.7.2 Free Send Data Message Buffers for Receiving 
Task 

6.2.7.3 Sample Programs Using SVC 6 Send Data 
Function 

6.2.8 Send Message (SFUN.MM) 

6.2.8.1 Message Buffers 

6.2.9 Queue Parameter (SFUN.QM) 

6.2.10 Change Priority (SFUN. PM) 

6.2.11 Send Logical Unit (SFUN.XSM) 

6.2.12 Receive Logical Unit (SFUN.XRM) 

62.13 Connect (SFUN.OM) 

6.2.14 Thaw (SFUN.TM) 

6.2.15 Sint (SFUN. IM) 

6.2.16 Freeze (SFUN.FM) 

6.2.17 Unconnect (SFUN.UM) 

6.2.18 Assign LPU (SFUN.LPU) 

O2«19 Transfer to LPU (SFUN.TL) 

6.2.20 Transfer to CPU (SFUN.TC) 


48-038 FOO ROL 


CHAPTERS (Continued) 


6.2.21 Release (SFUN.RM) 

6.2.22 Nonresident (SFUN.NM) 

6.2.23 Rollable (SFUN.RLM) 

6.2.24 Nonrollable (SFUN.NRM) 

6.2.25 Start (Bit Positions 29, 30, 31) 

6.2.26 Start Function for SVC 6 (SFUN.SIM) 

6.2.27 Start Function with Start Options for 
SVC 6 (SFUN.SOM) 

6.2.28 Delay Start Function for SVC 6 (SFUN.SDM) 
6.2.29 Delay Start Function with Start Options 
for SVC 6 (SFUN.SDM,SFUN.SOM) 

6.2.30 Wait Status Field (SVC6.TST) 
6.2.31 Error Codes (SVC6.STA) 


7 FILE HANDLING SERVICES SUPERVISOR CALL 7 (SVC 7) 


Tad INTRODUCTION 

7.2 SVC 7: FILE HANDLING SERVICES 

7.2.1 Function Code Field (SVC7.OPT) 

7.2.1.1 Allocate Function 

7.2.1.2 Assign Function 

7.2.1.2.1 Temporary File Allocation and Assignment 
Function 

7.2.1.3 Change Access Privileges Function 

7.2.1.4 Rename Function 

7.2.1.5 Reprotect Function 

7.2.1.6 Close Function 

7.2.1.7 Delete Function 

7.2.1.8 Checkpoint Function 

7.2.1.9 Fetch Attributes Function 

7.2.1.10 Vertical Forms Control (VFC) 

7.2.1.11 Fetch Time and Date Attributes from Disk 
Directory 

7.2.1.12 Fetch Logical Attributer of Open File 

7.2.1.13 Access Privileges 

7.2.1.14 Data Communications Access Methods 

7.2.1.15 File Types 

7.2.1.16 Read/Write Key Fields (SVC7.RKY/SVC7.WKY) 

7.2.1.17 File Size Field (SVC7.SIZ) 

7.2.1.18 SVC 7 Error Codes 


8 LOAD TASK STATUS WORD (TSW) SUPERVISOR CALL 9 (SVC 9) 


8.1 INTRODUCTION 
8.2 SVC 9: LOAD TASK STATUS WORD (TSW) 
8.2.1 Function and Description of the Task 


Status Word (TSW) 


48-038 FOO RO1 


oe ae 


CHAPTERS (Continued) 


9 


10 


LL 


12 


OVERLAY LOADING SUPERVISOR CALL 10 (SVC 10) 


ie E 


o:2 


SUPERVISOR CALL 10 (SVC 10) 


MESSAGES 


AUXILIARY PROCESSING UNIT (APU) CONTROL SUPERVISOR 


CALL 
10.1 


10.2 


10.3 


10.4 


LO:..5 


USER 


Liat 


DATA COMMUNICATIONS DEVICE DEPENDENT INPUT/OUTPUT (1/0) 


13 (SVC 13) 
INTRODUCTION 


FETCHING LOGICAL PROCESSOR MAPPING TABLE 
(ILPMT) 


FETCHING AUXILIARY PROCESSING UNIT (APU) 
STATUS INFORMATION 


AUXILIARY PROCESSING UNIT (APU) MAPPING 
FUNCTIONS 


AUXILIARY PROCESSING UNIT (APU) CONTROL 
FUNCTIONS 
SUPERVISOR CALL 14 (SVC 14) 


SUPERVISOR CALL 14 (SVC 14) 


SUPERVISOR CALL (SVC 15) 


12.1 


SUPERVISOR CALL 15 (SVC 15) 


SVC 1 Parameter Block Format and Coding 
Function Code Format for Data Transfer Requests 
Extended Options Fullword Format for Nonmagnetic 
Tape Devices 

Extended Options Fullword Format for Magnetic 
Tape I/O Operations 

SVC 1 Gapless Mode Parameter Block Format and 
Coding 

Function Code Format for Gapless Mode Data 
Transfer Requests 

IN-QUEUE or OUT-QUEUE Structure 


10-1 


LO-2 


10-2 


10-2 


10-3 


Ti=1 


Le 


48-038 FOO ROL 


FIGURES (Continued) 


a=) SVC 2 Code 1 Parameter Block Format and Coding 

gnZ SVC 2 Code 2 Parameter Block Format and Coding 

3-3 Task Impure Segment for SVC 2 Code 2, Option X'O00' 

3-4 Task Impure Segment for SVC 2 Code 2, Option xX'‘'80' 

3=5 SVC 2 Code 3 Parameter Block Format and Coding 

3-6 Task Impure Segment for SVC 2 Code 3 

3-7 SVC 2 Code 4 Parameter Block Format and Coding 

3-8 Program Status Word (PSW) 

3-9 SVC 2 Code 5 Parameter Block Format and Coding 

3-10 SVC 2 Code 6 Parameter Block Format and Coding 

i Hal Be SVC 2 Code 7 Parameter Block Format and Coding 

3-12 SVC 2 Code 8 Parameter Block Format and Coding 

3-13 SVC 2 Code 9 Parameter Block Format and Coding 

3-14 SVC 2 Code 10 Parameter Block Format and Coding 

3-15 SVC 2 Code 11 Parameter Block Format and Coding 

3-16 SVC 2 Code 15 Parameter Block Format and Coding 

3-17 SVC 2 Code 16 Parameter Block Format and Coding 

3-18 Packed File Descriptor Area 

3-19 SVC 2 Code 17 Parameter Block Format and Coding 

3-20 SVC 2 Code 18 Parameter Block Format and Coding 

3-21 SVC 2 Code 19 Parameter Block Format and Coding 
for Option X'00' 

3-22 SVC 2 Code 19 Parameter Block Format and Coding 
for Option x'Ool' 

3723 SVC 2 Code 19 Parameter Block Format and Coding 
for Option X'02' 

3-24 SVC 2 Code 19 Parameter Block Format and Coding 
for Option X'‘'03' 

3-25 SVC 2 Code 19 Parameter Block Format and Coding 
for Option xX'04' 

3-26 SVC 2 Code 20 Parameter Block Format and Coding 

3-27 SVC 2 Code 21 Parameter Block Format and Coding 

3-28 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'00' 

3-29 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'80' 

3-30 SVC 2 Code 23 Parameter Block Format and Coding 
for Option xX'‘'40' 

3-31 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'20' 

3-32 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'10' 

3-33 SVC 2 Code 24 Parameter Block Format and Coding 

3-34 SVC 2 Code 25 Parameter Block Format and Coding 

3=35 Area Receiving Accounting Information 

3-36 SVC 2 Code 29 Parameter Block Format and Coding 

5=1 Svc 5 Parameter Block Format and Coding 


48-038 FOO RO1 


vii 


FIGURES (Continued) 


= SVC 6 Parameter Block Format and Coding 6-2 
sad SVC 6 Function Code Field 6-6 
- Extended Load Options Field 6-13 
= Send Data Message Buffer Format for Calling Task 6-18 


j 


Send Data Message Buffer Format for Directed Task 6-20 


DOAMAMMHAMHAMAM 
i 
PrPCOYNMUPwWrh-H 


Message Buffer Format for Directed Task 6-26 
- Single Buffer Ring 6-27 
- Single Buffer Chain 6-28 
= Multiple Buffer Ring 6-29 
-10 Multiple Buffer Chain 6-30 
cae a Error Status Field 6-44 
f= 1 SVC 7 Parameter Block Format and Coding 722 
Fae” SVC 7 Function Code Field 7-6 
aks: SVC 7 Parameter Block Format and Coding for a 
Fetch Attributes Function 7-18 
7-4 SVC 7 Parameter Block Format and Coding for 
VFC Function feel 
7=5 SVC 7 X'FFOO', X'FFOL', or X'FFO2' Parameter 
Block Format and Coding for Fetch Time and Date 
Attributes Function 7-22 
7-6 SVC 7 X'FFO3' Parameter Block Format and Coding 
for Fetch Time and Date Attributes Function T1723 
caw: SVC 7 X'FFO4' Parameter Block Format and Coding 
for Fetch Time and Date Attributes Function 7-24 
7-8 SVC 7 X'FFOA' Parameter Block Format and 
Coding for the Fetch Logical Attributes of 
Open File Function 7-25 
8-1 SVC 9 Parameter Block Format and Coding 8-2 
8-2 Task Status Word 8-4 
TABLES 
1-1 0S/32 SUPERVISOR CALLS 1-1 
2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS 2-5 
272 FUNCTION CODES FOR COMMAND FUNCTION REQUESTS 2-17 
273 DEVICE INDEPENDENT STATUS CODES 2219 
2-4 DEVICE DEPENDENT STATUS CODES 2-20 
2-5 SVC 1 EXTENDED OPTIONS FOR LOCAL AND REMOTE 
COMMUNICATIONS 2-22 
2-6 EXTENDED FUNCTION CODES FOR CONTROL OPERATIONS 2-23 
2-7 MAXIMUM NUMBER OF BYTES ERASED 2-24 
2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS 2-25 


vill 48-038 FOO RO1 


TABLES (Continued) 


Ww WwW 
Ne 


NO Www 
i i 
NE Ow 


ana 
| 
on & W 


i 
I 
Wh 


SS] SJ SJ 
foi i 
NOOO 


10-1 


INDEX 


MAGNETIC TAPE DEVICE DEPENDENT STATUS CODES 


FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 


TRANSFER REQUESTS 
MAGNETIC TAPE DEVICE DEPENDENT STATUS CODES 
(GAPLESS ONLY) 


EXTENDED FUNCTION CODES FOR GAPLESS I/O OPERATION 


SVC 2 FUNCTION CODES 

TIME OF DAY VALUES CALCULATED IN SECONDS FROM 
MIDNIGHT 

TASK OPTIONS FROM THE TASK CONTROL BLOCK 
SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 
TASK WAIT STATUS BIT DEFINITIONS 


SVC6.FUN FUNCTIONS 

DESCRIPTION OF FUNCTION CODE FIELD FOR SVC 6 
CALLS 

EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 
WAIT STATUS BIT DEFINITIONS 

SVC 6 ERROR CODES 


SVC 7 FUNCTION CODE BIT DEFINITIONS 

ALLOWABLE ACCESS PRIVILEGE CHANGES 

DESCRIPTION AND MASK VALUES OF THE DEVICE 
ATTRIBUTES FIELD 

ACCESS PRIVILEGES DEFINITIONS 

DATA COMMUNICATIONS ACCESS METHODS DEFINITIONS 
READ/WRITE PROTECTION KEYS DEFINITIONS 

SVC 7 ERROR CODES 


TASK STATUS WORD BIT DEFINITIONS 
OVERLAY ERROR CODES AND MEANINGS 


SVC 13 FUNCTION CODES 


48-038 FOO RO1 


Ind-1l 


1x 


PREFACE 


This manual describes the 05/32 supervisor calls (SVCs) that 
provide the task interface to OS/32 system. services. The 
information in this manual is’ intended for assembly language 
programmers who design application level programs for operation 
in an O0S/32 processing environment. 


Chapter 1 presents an overview of all OS/32 SVCs, their 
functions, and the data structure of the SVC parameter block. 
Chapter 2 describes the Input/Output (I/0) Request Supervisor 
Call, (SVC 1) that is used to request specific I/O services from 
the OS/32 I/O supervisor. Chapter 3 details 22 general service 
functions provided by SVC 2. Chapter 4 presents the format for 
the End of Task Supervisor Call, (SVC 3) which is used to 
terminate task execution. Chapter 5 provides information on 
user-controlled loading of Link-generated overlays through the 
Fetch Overlay Supervisor Call (SVC 5). Chapter 6 describes the 
Intertask Communications Supervisor Call (SVC 6). Chapter 7 
details the File Handling Services Supervisor Call (SVC 7) which 
provides file and device handling functions supported by the file 
Manager and the data communications subsystem. Chapter 8 
describes how SVC 9 is used to replace the current task status 
word (TSW) located in the task control block (TCB) with a new 


user-specified TSW. Chapter 9 provides information on SVC 10, 
which handles the automatic loading of overlays generated by 
Link. Brief descriptions of the Auxiliary Processing Unit (APU) 


Control Supervisor Call (SVC 13), User Supervisor Call (SVC 14), 
and the Data Communications Device Dependent I/0 Supervisor Call 
(SvC 15) are given in Chapters 10, 11, and 12 respectively. 


Revision 01 includes a description of the SVC 2 code 29 for 
unpacking file descriptors, the SVC 7 fetch logical attributes of 
open file function, and the assign logical processing unit (LPU) 
and transfer to LPU function of SVC 6. This manual also 
introduces the APU Control Supervisor Call (SVC 13) that is used 
by tasks running on the Perkin-Elmer 3200MPS multiprocessor 
system. 


This manual is intended for use with the 0OS/32 R06.2 software 
release and higher. However, additional material specifically 
related to the Model 3200MPS System has also been included. 
These Model 3200MPS System features are supported by the 0S/32 
RO7.1 software release and higher. Throughout the text these 
features are identified as applicable only to the Model 3200MPS 
System. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
SUPERVISOR CALLS (SVCs) 


1.1 INTRODUCTION 


OS/32 provides each task with the support it needs to perform its 
designated function. In addition to programs that allow a_ user 
to design, implement, test, and execute tasks, OS/32 provides a 
number of system services that can be accessed by a task during 
execution. Included among these services are task timing, 
interrupt handling, input and output to devices or files, 
resource allocations, and intertask communication and control. 


A.task accesses a system resource by calling an OS/32 executor 


routine. An assembly program calls an executor’ routine by 
issuing a supervisor call (SVC). Table 1-1 lists the SVCs_ that 
access OS/32 system services for assembly tasks. These SVCs are 


divided into two groups: 


e SvCs for general use in both application and system level 
programs, and 


e sSVCs for use in system level programs only. 


This manual describes the SVCs designed for general use. SvCs 
designed exclusively for use in system level programs are 
described in the OS/32 System Level Programmer Reference Manual. 
These SVCs are indicated by an asterisk (*) or plus sign (+) in 
Table 1-1. 


TABLE 1-1 OS/32 SUPERVISOR CALLS 


User-written SVC 
Input/output (1/0) request 


Set status 
Fetch pointer 


” 

< 

Q 
NNMNNNN-EO 
* 

Q 

re) 

Q. 

co) 


SVC Code 0* Make journal entries 
1 

SVC Code 2 

SVC Code 3 Release storage 
4 
5 


| ' 
1 ' 
; Pause i 
| Get storage H 
{ ' 
| § 
{ ! 
| ' 
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TABLE 1-1 OS/32 SUPERVISOR CALLS (Continued) 
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SUPERVISOR CALL | FUNCTION 


Convert binary to ASCII 
hexadecimal or ASCII decimal 


SVC 2 Code 6 


SVC 2 Code 7 Log message 

SVC 2 Code 8 Interrogate clock 

SVC 2 Code 9 Fetch date. 

SVC 2 Code 10 Time of day wait 

SVC 2 Code ll Interval wait 

SVC 2 Code 14* Internal reader 

SVC 2 Code 15 Convert ASCII hexadecimal 
or ASCII decimal to binary 

SVC 2 Code 16 Pack file descriptor (fd) 

SVC 2 Code 17 Scan mnemonic table 

SVC 2 Code 18 Move ASCII characters 

SVC 2 Code 19 Peek 

SVC 2 Code 20 Reserved for sequential 


tasking machines 


SVC 2 Code 23 Timer management 

SVC 2 Code 24 Set accounting information 

SVC 2 Code 25 Fetch accounting information 

SVC 2 Code 26* Fetch device name 

SVC 2 Code 27* Memory Management 

SVC 2 Code 29 Unpack fd 

SVC 3 End of task 

svc 5 Fetch overlay 

SVC 6+ Intertask communication and 
control 

SVC 7+ File handling services 

Svc 9 Load task status word (TSW) 

SVC 10 Overlay loading 

Svc 13* Auxiliary Processing Unit 
(APU) Control 

Svc 14 Function determined by user 

Svc 15 Communications device 


i 
i 
} tasking machines 
1 
7 
{ 
H 
H 
i 
H 
H 
H 
: 
| 
i 
H 
H 
\ 
H 
H 
H 
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LEGEND 


* Documented in OS/32 System Level 
Reference Manual 


Reserved for sequential 


oe eee ee et 
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Programmer 


+ Additional functions documented in OS/32 System 


Level Programmer Reference Manual. 
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Perkin-Elmer also provides run-time library (RTL) routines’ that 
allow a program written in FORTRAN or Pascal to access system 


services. These routines issue general user SVCs for the task. 
A system macro library is also available that allows an assembly 
program to issue an SVC through a system macro call. See the 


OS/32 Application Level Programmer Reference Manual for _ an 
overview of the methods used by the application programmer. to 
access system services. 


1.1.1 The Supervisor Call (SVC) Parameter Block 


Associated with each SVC (except SVC 3) is an operating system 
Gata structure called a parameter block. The parameter block 
contains the data required by the OS/32 executor. Each parameter 
block has a specific length and format. The full length of a 
parameter block must be reserved even if certain parameters are 
not required by the particular SVC executor routine. 


To issue an SVC, a task must specify the identifying number of 
the SVC and the address of the SVC parameter block as operands to 
the call as follows: 


Format: 


SVC n,parblk 


Operands: 
n is a decimal number specifying the SVC. 
parblk is the label or address of the parameter block 


that contains the information necessary to 
execute the call. All parameter blocks must 
be fullword-boundary aligned. 


Execution of an SVC causes an interrupt that is processed by the 
Internal Interrupt Subsystem. See the 0OS/32 System Level 
Programmer Reference Manual for a description of SVC processing 
by the Internal Interrupt System. 


When building a parameter block structure, use the standard 
symbolic names that have been assigned to the fields and 
functional values for the parameter block. To obtain these 
standard names and their definitions, expand the appropriate data 
structure macro. These macros are contained in the OS/32 system 
macro Library, SYSSTRUC.MLB. See the Common Assembly Language 
Macro/32 Processor (CAL MACRO/32) and Macro Library Utility 
Reference Manuals. . 
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Use the following macro library utility commands to display the 
SYSSTRUC.MLB directory: 


*L, MLU32 

«ST . 

CAL MACRO LIBRARY UTILITY/32 03-340R00-00 
MLU >G SYSSTRUC.MLB/S 


MLU >DIR 

01/09/82 
$DCB$ $TCB$ $FCBS S$REGS§ $UDL$ $LIB$ $IOB$ 
$SVC1$ $ERRC$ $SVC13$ $APBS $SOPT $RREGS S$EREGS 
SUREGS $PSW $SPT $SPTE $$SPT $TABL$ $1VT 
$STE $PDCB $DDCB $PSDCB $DDE SMAGDCB §$VFDCB 
$SDCB $EVN $TMQ $SDE $CTX $RCTX $TCB 
$OCB $PSTCB $TSW $TOPT $TSTT $TWT $TLFL 
$TFL $TPRC $LTCB $LIB $LOPT $LSG $RLST 
S$RSARCPY $VD SDIR $ACB $FD $F DE $PFOB 
SFCB $FFLG $CCB $DATB $DFLG $DXFL $SVC1 
$S 1X0 $SVCIERR $SVC4 $SVC5 $SVC6 $SVC7 $SVC13 
SAPST $UDL $IOB $ IOBF $ 10H $SPOL $TERMUSR 
$AUF S$MTMSTE $ATF $GERC SEFMG $ESYS $EMIL 
$MERC SORT SODT $SPR $TQE $TQH $TQ27 
INTCPARM $QH SIPCB SIRCB $ICB $VFCHARS $TKQ 
$APB SAPRC SAPS $AOPT $TTB $LPMT $SYP 
105 MACROS IN LIBRARY MTM:SYSSTRUC.MLB/S 


MI.U 


Use the following macro library utility command to expand the 
desired structure: 


Format: 


LIST fd,macro 
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Example: 


LI M300:MAR,$SVC1 
MACRO 
$SVC1 
GBLB %SVC1l 
AIF (%SVC1) &SVC1X 


$SVC1 SETB 1 
SPACE 2 
SVvCl. STRUC STRUCTURE OF SVC-1 PARAMETER BLOCK 
SPACE 1 
SVC1.FC DS 0 FUNCTION CODE 
SVC1.FUN DS 1 (ALTERNATE MNEMONIC) 
SVC1.LU DS 1 LOGICAL UNIT 
SVC1.STA DS 1 STATUS FIELD 
SVC1.DN DS 1 DEVICE NUMBER 
SPACE l 
SVC1.SAD DS ADC BUFFER START ADDR 
SVC1.EAD DS ADC BUFFER END ADDRESS 
SVC1.RAD DS ADC RANDOM ADDRESS 
SVC1.LXF DS 4 LENGTH OF LAST TRANSFER 
ENDS 
SVC1X STRUC 
DS SvCl. 
SVC1.XIT DS 4 EXTENDED ITAM OPTION BITS 
ENDS 
SPACE 2 
a aS THE SVC-1 FUNCTION CODES 
SPACE 1 
SV1.CMDF EQU X'80' COMMAND 
SV1.READ EQU x'40' READ 
SV1.WRIT EQU X'‘20' WRITE 
SV1.BIN EQU x'10' BINARY 
SV1.WAIT EQU Xx'08' WAIT 
SV1.RAND EQU Xx'04' RANDOM 
SV1.UPRO EQU X'02' UNCOND. PROCEED 
SV1.IMG EQU Xx'OoOl' IMAGE MODE 
SV1.XIT EQU Xx'O1' ITAM EXTENDED OPT 
SPACE 1 
SV1.REW EQU X'CcO' REWIND 
SV1.BSR EQU X'AO' BACKSPACE RECORD 
SV1.FSR EQU X'90' FORWARD-SPACE RECORD 
SV1.WFM EQU X'88' WRITE FILE-MARK 
SV1.FFM EQU X'84' FORWARD-SPACE FILE-MARK 
SV1.BFM EQU X'82' BACKSPACE FILE-MARK 
SV1.DDF EQU x'81' DEVICE DEPENDENT FUNCTION 
SPACE 1 
SV1.HLT EQU X'80' HALT I/O 
SV1.SET EQU X'60' TEST & SET 
SV1.WO EQU x'O8' WAIT ONLY 
SV1.TEST EQU X'02' TEST 1/0 COMPLETION 
SPACE 1 


Rw K KKK KEKE RK KK RK KKK KK KK KKK KKK KKK KK 


&SVC1X ANOP 

MEND 
1 MACRO LISTED TO MAR: 
MLU 
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1.2 SUPERVISOR CALL (SVC) ERRORS 


The operating system informs the task of any error conditions 
encountered during SVC processing. Depending on the Kind of 
error encountered, the operating system: 


@ pauses execution of the task and displays a message on the 
system console, or 
@e stores an error code in the error status field of the Svc 


parameter block and/or sets the condition code. 


The first method is used when an error condition occurs as a 
result of a programming error in the task code (e.g., alignment 


or illegal instruction fault). If the user wishes the task to 
handle these errors, the task can take a trap that causes 
execution to branch to the task trap handling routine. See the 


OS/32 Application Level Programmer Reference Manual for more 
information on trap handling. 


The second method informs the user of the execution status of the 
SVC executor. 


1.2.1 Supervisor Call (SVC) Error Messages 


When the user chooses not to take a trap when an illegal 
instruction fault occurs, the illegal instruction trap bit is set 
to O in the current task status word (TSW). On encountering an 
SVC error, the operating system pauses the task and outputs a 
message to the system console. 


If the SVC error results from attempting to execute an undefined 


or illegal SVC or from specifying an invalid code for an SVC 2, 
the following message is displayed: 


ILLEGAL SVC - INSTRUCTION AT xxxxxx(yyyyyy) 


Where: 
XXXXXX is the relative address of the SVC instruction 
that caused the error. 
YYYYYY is the physical address of the SVC instruction 


that caused the error. 


1-6 48-038 FOO ROL 


If an address or alignment error occurs, the following message is 
displayed: 


Format: 


SVC ADDRESS ERROR - INSTRUCTION AT xxxxxx(yyyyyy ) 
SVC PARAMETER BLOCK AT xxxxxx(yyyyyy) 


Where: 
XXXXXX is the relative address of the SVC Or 
parameter block that caused the error. 
YYYYYY is the physical address of the SVC Or 


parameter block that caused the error. 


NOTE 


Systems equipped with a memory address 
translator (MAT) display the following 
message when an address or alignment 
error occurs: 


SVC ADDRESS ERROR-INSTRUCTION AT xxxxxx(yyyyyy) 
SVC PARAMETER BLOCK AT xxxxxx(yyyyyy) 
MEMORY FAULT ADDRESS = xxxxxx(yyyyyy) 


An address or alignment error can result from any one of the 
following conditions: 


1. The address specified for the SVC parameter block lies 
outside task boundaries. 


2. The address specified for the SVC parameter block is not 


aligned on a fullword boundary. 
3. The address specified for the SVC parameter block is not 


within a writable segment, which is required for that 
particular SVC. 
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1.2.2 Supervisor Call (SVC) Status Codes 


When an SVC execution error occurs, the operating system: 


@e returns an error code to the status field of the SVC parameter 
block, and/or 


e sets bits in the condition code (CVGL) to reflect the results 
of SVC execution. 


The status code returned depends on the particular SVC. Each SVC 
described in this manual has a defined set of status codes. The 
condition code, if set for the SVC, depends on the particular 
svc. Generally, a condition code of 0O indicates successful 
execution and termination. 


A nonzero error code may be returned to the status field of the 
SVC parameter block as a result of one of the _ following 
conditions: 


e The buffer to which the SVC parameter block is pointing is not 
aligned on the proper boundary. 


e An SVC parameter block that must point to a task writable 
segment is pointing to a buffer outside a writable segment. 


To test the condition code, use a branch mnemonic that tests’ for 
a true condition. 


Example: 


BTC PSW.CC, ERROR 


In this example, the condition code of the PSW is tested for’ the 
conditions specified by the mask field PSW.CC. PSW.CC is equated 
to X'F'. If any conditions tested are found to be true, a branch 
is taken to the location ERROR. For more information on branch 
instructions, see the Perkin-Elmer Processor User's Manual for 
your installation. 
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CHAPTER 2 
INPUT/OUTPUT (I/0) REQUEST SUPERVISOR CALL 1 (SVC 1) 


2.1 INTRODUCTION 


SVC 1 executes all general I/O data transfer requests’ and 
specific command function requests. General I/O data transfer 
requests refer to either a read or write operation. Before any 
data can be transferred, the user must specify whether it is a 
read or write, the address and length of the I/O buffer that will 
receive or send the data, and the logical unit (lu) assigned to 
the device to which the I/O is directed. These specifications 
are indicated through certain fields of the SVC 1 parameter 
block. 


When requesting a read or write operation, the user must describe 
in the SVC 1 parameter block the data being transferred and the 
environment during the transfer. For proper execution of a 
simple data transfer request, specify: 


e the structure of the file that a record is being transferred 
to/from (sequential or random), 


e the form the data is in when transferred (ASCII or binary, 
formatted or image mode), and 


e the state the calling task will be in during I/O (I/O proceed, 
I/O wait, unconditional proceed). 


If the device is busy when the data request is made, the user 
must decide if task execution is to wait, whether to queue the 
request and proceed, or whether to proceed and retry the _ 1/0 
request later. Link specifies the maximum number of I/0 requests 
that are to be queued at one time. The user also has the option 
to start I/O and continue task execution and then decide to’ stop 
task execution until the I/O is completed. If the device is free 
and the user wants exclusive access to a record or file (any file 
type), the user should execute a test and set operation to inform 
other tasks that the record or file is being used. 
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Onc 


e the read or write operation is completed: 


test for I/O completion (check the condition code, status 
fields, task queue, or execute a test I/O complete), and if 
the status fields indicate that no error has occurred; 


check to verify that all of the specified data was actually 
transferred (check length of data transfer field in the SVC l 
parameter block). 


All testing and checking for I/O completion can be accomplished 


thr 


ough the SVC 1 parameter block. 


Specific I/O command function requests that can be made through 
Svc 1 include: 


Bef 


Rewind 

Backspace or forward space record 

Write filemark 

Backspace or forward space filemark 

User-specified driver dependent functions (reserved) 


Halt 1/0 


ore a command function request is issued, the desired command 


must be specified, and the lu must be assigned to the device to 


whi 


ch the command is directed. These specifications are 


indicated through the SVC 1 parameter block in Figure 2-1. 
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2.2 SUPERVISOR CALL 1 (SVC 1) 


The SVC 1 parameter block must be 24 bytes long, 
fullword-boundary aligned and located in a task writable segment. 
Location within a writable segment is necessary so the status of 
an I/O request can be returned to the status fields of the 
parameter block. All fields in the parameter block are not 
required for every I/O request but must be reserved (see Figure 
Pages 1 


010) 112) 


H 12(2) Devic {3(3) Device 
| Function code} lu | independent } dependent | 
H | H status | status H 
Tein gece sara ea ce nae Aaa aise] 
14(4) | 
H Buffer start address 
1 i] 
Fe ek le : 
i8(8) 
H Buffer end address 
5 ' 
ean E ES eee Nn ee or oe ee ee ! 
112(C) | 
Random address 
| ! 
t 1 
i fe Sem mn (i i ek in nan ih ns’ Veen Sa eS ei in mised Vn as Ate GES a! se“ Sve lc es et Se hae he eee ala ley te nae H 
}16(10) 
Length of data transfer 
! ! 
' { 
| were: FanSite Sa gas a i VS cet as a el i es je a a a a eas a pa tly NAL hat ch Siesta Ot akan ages a eae enon fae ea ; 
120(14) 
Extended options 
! t 
| ! 

SVC 1,parblk 

ALIGN 4 

parblk DB X'function code' 

DB X'lu' 

DS 2 bytes for status 

DC A(buffer start) 

DC A(buffer end) 

DC 4 bytes for random address 

DS 4 bytes for length of data transfer 

DC Y ‘extended options' 


Figure 2-1 SVC 1 Parameter Block Format and Coding 
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Fields: 


Function 
code 


lu 


Device 
independent 
status 


Device 
dependent 
status 


Buffer start 
address 


Buffer end 
address 


Random 
address 


Length of 
data transfer 


Extended 
options 


is a l-byte field indicating whether a request 
is a data transfer or a command function, and 
the specific operation to be performed. Bit 
settings for data transfer requests are 
described in Table 2-1. Hexadecimal function 
codes for command function requests are 
defined in Table 2-2. 


is a l-byte field containing the logical unit 
currently assigned to the device to which an 
I/O request is directed. 


is a l-byte field receiving the execution 
status of an I/O request after completion. 
The status received is not directly related to 
the type of device used. 


is a l-byte field receiving the execution 
status of an I/O request after completion. 
The status received contains information 
unique to the type of device used. 


is a 4-byte field used only for data 
transfer requests and must contain the 
starting address of the I/O buffer’ that 
receives or sends the data being transferred. 


is a 4-byte field used only for data 
transfer requests and must contain the’ ending 
address of the I/0 buffer that receives or 
sends the data being transferred. 


is a 4-byte field containing the address 
of the logical record to be accessed for a 
data transfer request; a legal hexadecimal 
number must be specified in this field if bit 
5 of the function code is set to l. 


is a 4-byte field used only for data 


transfer requests. It receives the number of 
bytes actually transferred as a result of a 
data transfer request. If an error occurs 


during data transfer, this field is modified 
with indeterminate data. 


is a 4-byte field specifying device dependent 
and independent extended functions that must 
be executed by the device when it is servicing 
a data transfer request. 
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2.2.1 Data Transfer Requests 


Figure 2-2 shows the function code format for data transfer 
requests, and Table 2-1 defines each function code bit position. 


Format Access Extended 


Options 
Test Wait |Test I/0 
and set only |Complete 
SS eo eee eee 
:O;R iW} 
Bits 


Figure 2-2 Function Code Format for Data Transfer Requests 


TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 


REQUESTS 
BIT i 
| POSITION |} BIT NAME _ BIT SETTING AND MEAN ING 
{ 0 | Function code |} o = data: brangtar oe 
| type 
| shins bss ona “ins Sd sa Sin is“: Tms hm) in m/l itn ms Cabs clap ma. eas a iss Ss ii rs vis, os a ee ing na Sis an ac i, Ses ec, « a's) Sak sag a a “ale os ' 
H 1 {| Read } 1 = read Sperat ton: (Bit 2 
H H | must be set to 0. ) 
H a ea eas Se nen pi ht es si i ns. te “tvs lsat Wc ie em wim’ “ak es is cc Sms cw Ses ln neo-con Ses eS ae as hte a H 
i 2 | Write {| lL = write Spetavion. (Bit 1 
H { | must be set to 0.) 
LES Ae Ses Se eee een ae aS Oe ae ae ea ee PIRI oe | 
L=2 Test and set ll = test if a eneedrie record 


] ' 
i] ' 
! in a file is being used by | 
| another task. \ 
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TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


rn ee ee ne nen i a eet Rete ret eee ee ed 


BIT 
POSITION BIT NAME err SETTING AND MEANING 
3 0 = eHe Gata to be Lvaneterred 
is in ASCII format. 


1 = the data to be transferred 
is in binary format. 


If bit 7 of the function 
code is set to indicate 
image I/O transfer, the 
setting of bit 3 is 
ignored and the data is 
transferred in image 
format. 

“1/0 sreesed O = If the devices is not busy, 
return control to the call- 
ing task after initiation 
of data transfer to the 
device. However, if the 
device is busy, the request 
is queued and task execu- 
tion continues. 


ee ee ee ee ee nee mee eee ee ee eee 
men ee ee me ee eee ees em ee ee eee ee 


Wait I/O 1 = stop task execution, ini- 
tiate data transfer to the 
completion of I/O. 

Wait only l = task execution stops and 


waits until the completion 
of all queued I/0 proceed 

requests to the specified 

lu. 


When a wait only request is 
issued, bit 4 is the only 
bit set in the function 


i 

H 

\ 

| 

H 

\ 

H 

\ 

H 

\ 

i 

device, and wait until the 
i] 

| 

code. 


me eee ee eee ee wre ee ee ee es eee ee wees eee eee ee 
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TABLE 2-1 


BIT H 
POSITION | 
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FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


Sequential 


Random 


Conditional 
proceed 


Unconditional 
proceed 


Test I/0 
complete 


wee eee ees ee re ee ee ee ee ee ee eee eee eee ee ee eee ee ee ee ew ewe oe 


C—O en a dnd 


access the next logical 
record. 


access the logical record 
specified by the hexadec- 
imal value in the random 
address field of the para- 
meter block. The associa- 
tion of the hexadecimal 
values with the logical 
record must be established 
before the data transfer 
occurs. 


acne licamesticemedll meee neler nse eet ae ore are ene A ae eet et ee ee ee a ree eee eee Eee ne gnC es ene Mon ecommerce mnae 


after the I/0 Paquest is 
issued, put the task into a 
wait state if the requested 
device is busy and the 
total number of queued re- 
quests exceeds the maximum. 
Once the I/O request is 
completed, the task resumes 
execution. If the maximum 
number of queued requests 
is 1, a pending request 
causes the task to be 
placed into a wait state. 


any I/O request made toa 
device that is busy is re- 
jected if total number of 
queued requests exceeds the 
maximum, and task execution 
continues. 


test to check for the com- 
pletion of I/O to a speci- 
fied lu. 


If a previous I/O proceed 
request or queued [I/O pro- 
ceed request does exist, 
the condition code is set 
to X'F'. However, if there 
is no outstanding I/O pro- 
ceed request, the condition 
code is set to X'O'. 


TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


BIT 
POSITION |; BIT NAME BIT SETTING AND MEANING 
sso ee ee er ee ee ee ee ee ee ee 2 
H { When a test I/O complete { 
H ' request is issued, bit 6 H 
is H is the only bit in the | 
' H function code set. If bit 4 } 
H H is set, it is ignored. { 
‘ 
' 
Format O = the data being transferred 
is formatted as indicated 
by the bit 3 setting of the 
function code and according 
to the device type speci- 
fied. 


Extended/ 
image options 


i 
i 
i 
i i 
| 1 = tests the setting of the 
: XSVC1 task option. If { 
H XSVCl1 is off, an image I/O | 
H transfer is performed. If | 
H the option is on, the 
| extended options fullword 
1 in the parameter block is 
H checked for specified H 
i options. 
J | 
( ! 
H When an image I/O is per- 
! formed, the data being H 
i transferred is in image H 
H mode and is not formatted. i 
H In effect, the user must i 
H explicitly specify any con- | 
H trol characters such as H 
{ carriage returns or line H 
H feeds on writes and will { 
1 receive exactly what is H 
| input on reads. | 


ee ee enn ne ee eee nen nn eee ee ee 
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2.2.1.1 Test and Set 


The test and set function can be used to write a program that 
prevents multiple tasks from modifying a record simultaneously. 
A task that issues an SVC 1 with the test and set bit enabled 
notifies other tasks that it is using a record by setting the 
first bit of that record to l. This bit setting is called a 
one-bit record lock. Any task subsequently performing a test and 
set on the record is informed that the record is being accessed 
by another task. 


To use the test and set function, set both bits 1 and 2 of the 
function code field to l. If the test and set operation is used 
to lock out a record written in binary image mode, make certain 
that the first bit in the record is initially set to zero. In 
addition, the size of the user buffer should match the size of 
the file record. The following diagrams demonstrate how a test 
and set operation is performed. 


In the first diagram, the calling task issued an SVC 1 with test 
and set enabled to read a record into its user buffer specified 
by the SVC 1 parameter block. Notice that the bit setting for 
the record lock bit is 0, indicating that the record is not being 
used by another task. 


Record 
lock 
bit Record Lengt 
~~ eee 
Record lo Pee eee eee ee Le ead Se aoe 
on 1:0} H 
Disk 9 === 4 {Gee Sere er Saas aera. esate Ss 
Bytes 
0 99 255 
1 sector 
Record 
lock 
bit 
Record y at nae 4 f----- 
Transferred i; Of 
to User ------- 4 f------ 
Buffer Bytes: 
0 99 
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a wee ee ee ee ee 


me ee ee 


oe ee ee en oe ee ee we 


ee ee red 


we wee we 


ee eee 


After the record is read into the user buffer, the test and set 
operation tests the record lock bit. If the bit is 0, the record 
lock bit in the user buffer is then set to 1. The following 
diagram shows the record lock bit settings after the test 
operation is performed. 


Record t ——— Ol rc ae ae a oe CO ria aca ira und aaa 
on {0} H H 


Disk === 4 pennnn nn n--------- SS ee 


User 1. co ip Soa 4 ¢------- 
Buffer 11} 


After the record lock bit is tested, the SVC 1 test and set 
function then sets the record lock bit on disk to 1 so that other 
tasks attempting to modify the record are notified that the 
record is in use. SVC 1 sets the record lock bit on disk by 
copying the contents of the user buffer to the record's original 
location on disk. In addition, SVC 1 sets the condition code to 
X'O' and resets the record lock bit in the user buffer to QO. 


The following diagram shows the results of the completed test and 
set operation. 


Record 

lock 

bit 
Recor@.  *#+=-= SS aaa Seas of eee See Se 
returned 11} | i 
to @isk = = = 2 9 =------ 4 Canes sea eeas SaaS 
with Bytes: 
record 0 99 255 
lock bit 
set 
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lock 
bit 
ee eye pom eaee 

User rol | 
buffer 9s rere $ G------- 
with Bytes: 
record 0 99 
lock bit 
set to 0 


Condition Code 


Ce 


If the calling task had performed a test and set operation on a 
record that had a record lock bit setting of 1, the condition 
code would be set to X'F'. The following diagram shows’ the 
record lock bit settings and condition code resulting from this 
test and set operation. 


Record 

lock 

bit 
Record #----- Bye as mae nye eng) Se ~--- 
on disk il} H 1 
WIEM ar ag: RR ie ee ee S. eS eees 
record Bytes: 
lock 0 99 255 
bit set 

Record 

lock 

bit 

bg pee 
User iL} 
DUEfer-: ce Seeees Se eK aS a= 
with Bytes: 
record 0 99 
lock bit 
set to l 
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Condition Code 


ee ee ee eee 


a A oe A ee eke ee ee ee ee ee 


After a test and set operation, a record protection program 
checks the condition code. If the condition code is zero, the 
task can then proceed to modify the record. If the condition 
code is xX'F‘', the task should retry the test and set operation 
before attempting to modify the record. 


To unlock the record on disk, the task that set the record lock 
bit should write the record in its user buffer back into its 
original location on disk, whether or not the task modified the 
record. 


If the size of the user buffer is less than the size of the 
record, the following will occur when the record in the user 
buffer is written back to disk: 


e If the record in the user buffer is written back to an indexed 
file, the remaining bytes of the record will be filled with 
zeros. 


e If the record in the user buffer is written back to a 
contiguous, nonbuffered indexed, or extendable contiguous 
file, the last two bytes of the record will be propagated to 
the right until the remaining bytes of the record are filled. 


The following diagram illustrates how a user buffer smaller than 
a 256-byte contiguous file record is returned to disk. Notice 
that the last two bytes of the record in the user buffer are 
propagated to the right to fill a 256-byte sector on disk. 


Record Last two bytes 
lock of record 
99-byte bit 
Record 
Ti t—i—“(CtsC~SC Ca f GS 
User (Oj 14D} 50} 
Buffer RE Pee a 
Bytes 
0 99 
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Record Last two bytes 


Lock of record 
bit 
99-Byte i 
Record #----- 5. Petes HS Sem eee eos 3S feees as te cn 
Returned 10} 14D}50;4D{50/4D;50;4D; {|4D;50;4D;50; 
to Disk = = ------ Se ae Sa ee a ae a Ot, (eae ee eee 
Bytes: 
0 99 255 


The test and set operation can be executed as a wait I/O or I/0 
proceed request. Setting the condition code during a test and 
set operation occurs only when wait I/O is specified. (Bit 4 of 
the function code is set to 1.) However, if an I/O proceed is 
requested (bit 4 of the function code set to 0), setting the 
condition code is not useful because it could be changed at any 
time during task execution when data transfer and task execution 
take place concurrently. Therefore, check the record lock bit in 
the buffer to determine whether the record is currently being 
used. See the OS/32 System Level Programmer Reference Manual for 
the devices supporting test and set. 


The following sample program demonstrates how the test and set 


function can be used to write a program that provides record 
protection. 
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Sample Program: 


* 4 & HH MH RH HH HH 


TESTSET 


TESTSET 
x 


LOOP 


CONTO5 


* 
* 


CONT 10 


* 
* 


CONT20 


x 
x 


CONT30 


* 
* 


CONT40 


TEST AND SET 


PRIOR TO PROG 


EXAMPLE 


RAM EXECUTION ASSIGN LU 1 AND LU 2 


TO A TEXT FILE CREATED BY EDIT32. 


LU 1 AND LU 2 
TASKS. 


PROG 

ENTRY TESTSET 
EQU x 

LIS 1,0 
EQU x 

ST 1,PBl1t+!I 
ST 1,PB2+1 
svc 1,PB1L 
BZ CONTOS 
PAUS ERROR; 
EQU x 

LA 14,PBl 
BAL 15, @I10E 
EQU bed 

svc 1,PB2 
BM CONT20 
PAUS ERROR; 
EQU x 

L 2,B1S 
ST 2,B1S 
WRITE RECORD 
svc 1,PB3 
svc 1,PB2 
BZ CONT30 


PAUS ERROR; 


EQU a 

svc 1,PBlL 
BM CONT40 
PAUS ERROR; 
EQU * 

L 3,B2S 
st 3,B2s 
WRITE RECORD 
WRITE LU=2,RE 
AIS 1,1 

B Loop 
IOPCB FUN=X'7 
IOPCB FUN=X'7 
IOPCB FUN=X‘'3 
ALIGN ADC 

DS 80 

EQU x-] 

DS 80 

EQU =) 

END 


SIMULATE ACCESS OF THE FILE BY TWO 


TEST AND SET EXAMPLE 


SET UP FIRST RECORD NO. 
O.RECNU FOR LU 1 
O.RECNU FOR LU 2 

READ & TEST RECORD ON LU 1 

OK; RECORD IS NOT LOCKED 
RECORD IS LOCKED; SHOULD BE FREE 


PB ADR FOR EOF TEST 


RR CHECK FOR END-OF-FILE 


READ AND TEST RECORD ON LU 2 
OK;RECORD IS LOCKED 
RECORD IS FREE; SHOULD BE LOCKED 


MANIPULATE RECORD DATA 


BACK TO FLE AND UNLOCK IT 


READ AND TEST RECORD ON LU 2 
OK; RECORD IS FREE 
RECORD IS LOCKED; SHOULD BE FREE 


READ AND TEST RECORD ON LU 1 
OK; RECORD IS LOCKED 
RECORD IS FREE; SHOULD BE LOCKED 


MANIPULATE RECORD DATE 
BACK TO FILE AND UNLOCK IT 
CNUMB=(1),ADDR=B2S, ENDADDR=B2E 

INCREMENT RECORD COUNTER 

DO NEXT RECORD UNTIL EOF 
6',LU=1,ADDR#B1S , ENDADDR=B1E, RESTART=CONTO5 


6',LU=2,ADDR=B2S , ENDADDR=B2E 


6',LU=1,ADDR=B1S , ENDADDR=B1E, RECNUMB=(1) 


BUFFER FOR LU 1 


BUFFER FOR LU 2 
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2.2.1.2 Input/Output (1/0) Proceed 


An I/O proceed request is initiated when bit 4 of the function 
code is set to O and a read or write operation is specified. 


If the device is free when a data transfer request is made with 
I/O proceed specified, task execution and data transfer take 
place concurrently. When the I/O is completed, the status of the 
Gata transfer is returned to the status fields in the parameter 
block. An illegal function code or illegal lu causes the status 
to be returned to the status fields before data transfer starts, 
resulting in rejection of the I/O proceed request. Since task 
execution and data transfer take place concurrently, the task 
must check for the completion of I/O. There are four ways to 
check for I/O completion: 


l. Execute a test I/O complete operation. 


2. Monitor the status fields in the SVC 1 parameter block 
issuing the request. 


3. Take a trap when I/O is completed and branch to ae service 
routine. 


4. Issue a wait 1/0 request to the device specified by the SVC l 
making the request. This function will stop task execution 
until I/O is completed. 


5. Queue I/O requests by specifying the IOBLOCK parameter of the 
Link OPTION command and issue the wait only function. This 
will stop task execution until all queued requests to a 
specified device are completed. 


An SVC 1 I/O proceed request to an indexed file executes in a 
different manner than an I/O proceed to other file types or 
devices. See the OS/32 Application Level Programmer Reference 
Manual for more information on I/O operations to indexed files. 


2.2.1.3 Queuing Input/Output (1/0) Requests 


When SVC 1 issues an I/O proceed request to a device that is 
busy, the request is placed on the calling task's I/O control 


block, and task execution continues. The request is serviced 
when the device is free. Normally, each task has only one I/O 
control block on which to queue an I/O request. To queue more 


than one request, use the IOBLOCK parameter of the link OPTION 
command to assign more blocks to the task. 
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Format: 


OPTION JOBLOCK= 


Parameter: 


b is a decimal number from 1 through 65,535 
indicating the maximum number of I/0 control 
blocks assigned to a task. Each I/0 control 
block can contain one queued I/O request. If 
this option is not specified by the user, Link 
automatically assigns one I/O control block to 
the task. 


2.2.1.4 Conditional Proceed 


If the number of queued requests exceeds the maximum number of 
I/O blocks assigned to the task and bit 6 of the function code is 
set to 0, SVC 1 places the task in a wait state until one of the 
queued requests is serviced. Task execution resumes when the 
number of queued requests equals the maximum number set by Link. 


The number of I/O requests a task can issue before going into the 
wait state is determined by the formula: 


b + 1 + number of logical units assigned to task 


Parameter b is the number of I/O control blocks assigned to the 
task. 


2.2.1.5 Unconditional Proceed 


To prevent the task from going into the wait state when the 
maximum number of requests specified by Link are queued, set bit 
6 of the function code to 1. This code allows the task to reject 
all I/O requests made to a busy device after the maximum number 
of requests are queued. When a request is rejected, a status of 
O is sent to the device independent status field, and the 
condition code is set to X'F'. The user can retry the rejected 
I/O request during task execution. 
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2.2.1.6 Wait Input/Output (1/0) 


To stop task execution during a read or write operation, use the 
wait I/O function. A wait I/O request is initiated when bit 4 of 
the function code is set to 1 and a read or write operation is 
specified. 


If the device is free when a data transfer request is made with 
wait I/O specified, task execution stops, I/O is initiated, and 
the task waits to resume until I/O is completed. Status of the 
data transfer is returned to the status fields when the I/O is 
completed. 


If the device is busy when a data transfer request is made with 
wait 1/0 specified, the request is queued and task execution is 
suspended until the queued request is serviced and I/O is 
completed. Then, task execution resumes. 


2.2.1.7 Wait Only 


A wait only request stops task execution until all 1/0 proceed 
requests to the specified lu (including queued requests) are 
completed. When the last queued I/0 proceed request is 
completed, task execution continues. The status of the last 
completed I/O proceed request is returned to the status field of 
its respective SVC 1 parameter block. 


To issue the wait only request, set the SVC 1 function code field 
to X'08', and the lu field to the appropriate device. A nonzero 
status code will be returned to the status field of the SVC l 
wait only parameter block if any of the following conditions 
occur: 


® Logical unit is illegal (code X'81'). 
e Logical unit is unassigned (code X'‘'81'). 


@e Wait only request is issued for a pseudo device without SVC 
interception (code X'CO'). 


2.2.2 Command Function Requests 


All command function requests and task execution take place 
concurrently. Queued requests are handled the same way as 
conditional proceed data transfer requests. When the I/0 is 
completed, the status of the command function is returned to the 
status fields in the parameter block. An illegal function code 
or illegal lu causes the status to be returned to the status 
fields before the command function starts. This results in 
rejection of the command function request. 
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Since task execution and command function requests take place 
concurrently, the task must check for I/O completion. These 
three methods are used to check for I/O completion: 


1. Execute a test I/O complete operation. 


2. Monitor the status fields in the parameter block for the 
command function status to be returned. 


3. Issue a wait only request to the device specified by the SVC 


1 making the request. This function will stop task execution 
until I/O is completed. 


Table 2-2 defines the function codes far command function 
requests. 


TABLE 2-2 FUNCTION CODES FOR COMMAND FUNCTION REQUESTS 


' FUNCTION | 
CODE MEAN ING 
|e eens soe eee EE SR ESSE Se eee ee SE See ee SES eee eee a= | 
X'CO' {| Rewind - a rewind operation is to occur on t 
t i the SDEGr ce lu. { 
; ht ae ES eh Na Ss i a a a a a Na a i Ea a a as ae a ee es a eae { 
X'AOQ' | Backspace record - The device Senigued to H 
; the lu is to packePsce. one record peng ths t 
Pre eae an cer tr et eee gine gg ear pee ce ee eNO eg eh Ne, 
X'9O0° { forward Space record - The device easigned H 
; to the lu is to move forward one record 
t | Length. { 
} Sn nih ‘Sy a i i is a oe Sa at tan ea Gc ell feb SS wal» tee ea sd) iS i ni el H 
X'88' | Write fi Lemark aan fiienark is to be written | 
I ; at the current pointer position on the de- H 
H | vice assigned to the lu. t 
a a a aa a di enact t 
H X'84' | Forward space Ciomark - The davies assigned 1 
H i to the lu is to move forward past the next 
{ H sweets to the Reg tin ehg of the next file. H 
! wi i a a as is GSS Sa owe aa Ya Se cas hs ad seca i pS “hmm cess Sed ‘Sls “ps Sui'mna’ c’sis-> lng c-whcs Use sen rms \ 
X'82' | Backapace filemark - The device assigned to | 
H i the lu is to backspace to the previous 
{ | filemark. For disk files, this positions H 
i | the pointer to the beginning of the previous | 
H i file. For magnetic tape files, the tape is j{ 
H H poate toned at the end of the previous chance { 
H a at Se Sk a ec i eS nS at a al Ses esl Se! pep (Sanwa aaa csc cs SSS spl Se phen | 
X'81' {| Reserved for driver dependent functions. 
a a clas las See asap i ns tee eae ce wee ce) ce la Se a hea es Amn" Sans is Tc ce bam fe ccs enon se Sica) Samy. an en Sm cg” et, en aun “hes Cefes wse cophsSapeacen 
X'80' ! 


| Halt I/O - Cancel all previous I/O proceed 1 
} requests to the specified lu. 


see me mt eS a ae in nam a ea eae me mt em eee tas eR amen ee me ee cee ed ee em cere ma arm ee seem ee rm Se mem cre nem ce teem tome 
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Vey prey aren o Halt Input/Output (1/0) 


When a halt I/O request is issued, any previous I/0 proceed 
requests, whether they are in progress or queued to the specified 
lu, are cancelled. When the I/0 is terminated, the task that 
issued the I/O proceed request takes a trap (if enabled), the 
request is queued, and the _ status of the I/O operation (data 
transfer or command function) is returned to the status fields of 


the parameter block issuing the request. The time of actual 
termination is asynchronous to the time the halt I/O is issued. 
The independent status codes are listed in Table 2-3, and _ the 


dependent status codes are listed in Table 2-4. 


When an I/O request is issued to an lu and a previous I/O proceed 
request exists for that same lu, the second request and any 
subsequent requests to that lu cannot be serviced until the 
previous I/O request is completed. By issuing a halt I/0 
request, the first I/O request is cancelled, allowing I/0 
requests issued after the cancellation to be started on the 
device. 


If the IOBLOCK option was specified by Link and at least one I/O 
request to a specified lu is queued, execution of a halt 1/0 
request cancels any I/O to that specified lu already queued or in 
progress. See the 08/32 System Level Programmer Reference Manual 
for the devices supporting the halt I/O request. 


2.2.3 Logical Unit (lu) 


An lu is a decimal number ranging from 0O through 254. The 
highest lu number to which a task can be assigned is determined 
by the lu parameter of the Link OPTION command. After loading 
the task into memory, the lu should be assigned to a particular 
file or device through SVC 7 or an ASSIGN command. If no actual 
I/O operation is desired, the lu should be assigned to NULL:, 
causing a no-operation (no-op) to occur. 


2.2.4 Device Independent Status 


Logical units provide device independent I/O by causing all I/O 
requests to be made directly to the lu and not to the device. 
The execution status of an I/O request that is independent of the 
physical characteristics of the device being used is returned to 
the device independent status field of the parameter block. See 
Table 2-3. The data remaining in this field from a previous’ I1/0 
request are not modified until a subsequent I/O is completed or 
an error occurs. 
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TABLE 2-3 DEVICE INDEPENDENT STATUS CODES 


I 


STATUS jj} 
CODE | MEAN ING 
‘ Sse eS Ss ae Sr SR SST SSE SSS VT SSK SSE STS SSS SSS SS SS ST ST SV STS SS STE SST SK STS SST SSS SS 
X'CO' | Illegal function - An error is present in 
| the function code; the requested function 
| is not supported by the device or assigned 
; access privilege, or the buffer transfer 
| igs too small. (When using tape, minimum 
| buffer size is four bytes.) 
| Device unavailable - The device is either 
{| inoperative or not configured into the 
; system. 


| End of medium (EOM) - “The I/O directed to 
| the lu reached the physical end of the 

| device; e.g., end of tape. During magnetic 
; tape operations this status may be com- 

| bined with one of the next three status 

| codes, yielding X'98', X'94', and X'92'. 

t End of file (EOF ) - The logical end of the 
| file specified by the assigned lu was 

{| reached. 

i Unrecoverable error - An error occurred 

{ and the I/O request, which terminates 

; task execue tony cannot be retried. 

Parity - An even or odd parity error 
occurred on a data transfer request. 


H 
H 
H 
i Recoverable error - The I/O request is re- 
{| coverable and can be retried. A write 
| request was issued to a write-protected 
| device. 
! 
{ 
| No I/O currently being processed - If a 
| halt I/O request is executed, this bit is 
| set, indicating that no I/O is being pro- 
} cessed at this time. 
| [llegal or unassigned lu - The lu 
| specified in the parameter block is either 
{| incorrect or was not previously assigned. 
X'OO' | Normal execution - I/O is completed and 
| no error occurred. 


mee on mY ag fe cae ee nme em Sart en ee meme S/O EA Sees SEGUE muah mh ERS i see hems nth ee std Ha em vas MED rt me RD ae EDO eo 
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2.2.5 Device Dependent Status 


The execution status of an I/O request that is directly related 
to the unique characteristics of the device being used is 
returned to the device dependent status field of the parameter 
block. See Table 2-4. The data remaining in this field froma 
previous I/O request are not modified until a subsequent 1I/0 
request is completed or an error occurs. 


TABLE 2-4 DEVICE DEPENDENT STATUS CODES 


Daath ees Masel Moen rent anaee ll scan i area nen cena ee en ere re re ee ee ee ee ne nee nn nn ne ee ee neo 


{| STATUS | 
| CODE |} MEAN ING i 
H ses SSS SES SSS SS SS SST ST ST SS SSS SS Sentero eso meee eee eee | 
i X'85* {| Exhausted retries on seeks - Seeks on disk } 
{ | Gevices have been retried the maximum 
{ i number of times. 
H a as en i ann inc: ss “an aka ‘eno nao pn Sl “ny i ih ac Sel“ ae Te ee RN dans sot om th Sn, Laas a ne am he H 
1 X'84' | Queuved I/O terminated - A eucued 1/0 
| request is terminated because a previous 
i I/O request failed. 
H Fs ms Ce Si sem Sn i nis i i as ea ct is “aan Gah it "So el sian nt sl GN, ede: ein ig aan it deal a dae rae H 
i; X'83' | Device is write- eicbeck ea - A write opera- | 
{ ij tion to a write-protected device occurred. | 
ae aeeknacee nies ar ota eax anna SLR es | 
i X'82' {| Read/write timeout - A read or write canies 
; out condition occurred. 
leiaare cote a ce ae gk ow oe 1a nine nee Re en Ga oe | 
i X'81' {| Terminated by Halt I1/0 - 1/0 was termina- | 
{ } ted by a halt I/O operation. 
Ce rn salary che OAC SUR URE Ea ak Sa ON es AR eG a | 
x'OO' Normal execution - I/O completed and no 


'] 
I 
} error occurred. 


Oe Ne ee ee 


2.2.6 Buffer Start/Buffer End Address 


The buffer start/buffer end addresses specify the buffer to be 
used for data transfer requests. The start address is the first 
byte in the buffer. The end address is the last byte in the 
buffer that is included in the transfer. 
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Starting Ending 


address . address 
X'150' Data buffer X'19F' 
apelin is a TGR PORE RE a CR 4 §-~--~---------------- === 
] 1 t I 
1 i] { ( 
sit Sohn Sinn tah : Ma ae: e Sthtk Dad, eas Ne ak a ae -t Secila ae dt 4 Persea s sae Sasa es 
Bytes 
0 79 


2.2.7 Extended Options 


If bit 7 of the function code is set to 1 and the xXSVCl_ option 
was specified at Link time, the options specified by the SVC l 


extended option field are executed. The extended options 
fullword format is dependent upon the device that an I/O request 
is directed to. In general, there are two formats: one for 


nonmagnetic tape devices and one for magnetic tape devices. 


2.2.7.1 Nonmagnetic Tape Devices 


If a device is supported by the data communications subsystem, 
the extended options provide device dependent, communication 
dependent, and device independent features when a read or write 
operation is performed. 


Figure 2-3 illustrates the fullword format of the extended 
options field of the SVC 1 parameter block for devices supported 
by the communications subsystem. 


Function modifiers Extended functions 


ete ee cmt et et get ae ae Re eS EY Ry eT a SE co ee ae AR ae AD ED ARE ST A OS ER YS eS AA OD LO, em I 


Re ne re Ret en nee ee eel nn enenetnti tinted 


Figure 2-3 Extended Options Fullword Format 
for Nonmagnetic Tape Devices 


Bits O through 15 are for general use in both local and remote 
communications. 


Bits 16 through 25 are used to expand ae function's capability. 


For example, the write edit function can be expanded to write 
blinking by using a function modifier. 
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Up to 64 device dependent I/O functions can be specified by bits 
26 through 31. These extended functions are mutually exclusive; 
however, an I[/O with multiple requests or operations can _ be 
performed. 


Table 2-5 describes the SVC 1 extended options that can be 
specified for both local and remote communications. See the 
0OS/32 Basic Data Communications Reference Manual for a listing of 
device dependent extended functions along with their applicable 
function modifiers. 


TABLE 2-5 SVC 1 EXTENDED OPTIONS FOR LOCAL AND REMOTE 
COMMUN I CATIONS 


BIT 
POSITIONS | BIT NAME H BIT SETTING AND MEANING 
0 i; Connect (CON) ; 1 = terminal manager answers a 
telephone ring on a dial-in | 
i line during a read or 
| write line initialization H 
H sequence. H 
{ 
I 
;} L = terminal manager disconncees 
(DCT) | from a switched line H 
H following final data trans- jj; 
H fer 
Se ees ase: Say a Fae, nc ee a cae eee i fc ek oo oa et, ee ew Gl te a, Se a a aks Se See i 
Image/format 0 = data Hedng peanamieced is 
(IMG/FMT ) in image mode and is not 
formatted. 


H H 
1 i 
{ | 
‘] ' 
! 1 
| 
; Ll = terminal manager performs H 
H normal record buffering, H 
{ inserts or deletes line H 
H control characters, and | 
| recognizes appropriate data | 
| format control characters 1 
' on transmitted data. H 
Sei eh i in (je eis se i sri’ ns | ma) wr i ne cit Ce esa see on’: ose soa esa Vass wn ccs ws Nk ae gaan' eh asa ksi es es Binal ek bn sna oa tees To eee age i 
H } 00000 = these bits are ecnerved H 
for future use. 


J 
t 
| Vertical j 1 = requests vertical exe { 
| forms control |} control option for an ASCII | 
i (VFC) | I/O operation. 

‘ 

‘ 


Lee reetie lier cee liciengtiemee i er TR eee nnn enc ee ee ee ee) 
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2.2.7.2 Magnetic Tape Devices 


The extended options fullword format differs when I/0 is being 
directed to a magnetic tape device. Figure 2-4 illustrates the 
fullword format of the extended options field of SVC 1 parameter 
blocks used for magnetic tape I/O operations. 


Extended function code 


rr nt aa ie i i i ie ire i ir.) ine nnn ene en ed ee ee ee ee 


Figure 2-4 Extended Options Fullword Format for Magnetic Tape 
I/O Operations 


If the extended function code requires an additional parameter, 
the most-significant bits (0-7) contain the parameter value. 


Bits 8 through 26 are not used during magnetic tape I/0 
operations. Bits 27 through 31 contain the extended function 
code that indicates the type of I/O operation to be _ performed. 
The extended function codes available for use in this field are 
dependent upon the standard function code setting in the SVC 1 
parameter block. Table 2-6 contains the extended function codes 
available when the standard function code bit setting indicates 
a control operation. 


TABLE 2-6 EXTENDED FUNCTION CODES FOR CONTROL OPERATIONS 


ee re ee er er eee Re eee ee ee ee es ee) 


section of tape (approximately 3 to 3.5 inches) in 
the forward direction. 


| EXTENDED | 

i FUNCTION | 

H CODE OPERATION/EXPLANAT ION 

i ed er a a Bo Bd ad 2 2 2 ee ee 2 ed 
H 0 | REWIND AND UNLOAD - The tape is rewound to begin- 
i ning of tape and then unloaded. Requires hardware 
H | support. . 

1 ' 

1 { 

1-6 | RESERVED 

' 1 

1 ' 

H 7 | CREATE A GAP - The drive is instructed to erase a 
{ { 

{ | 
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TABLE 2-6 EXTENDED FUNCTION CODES FOR CONTROL OPERATIONS 
(Cont inued) 


i bo} I 


8 | READ DRIVE STATUS - A task can read 8 status 
halfwords into the buffer space specified in the 
SVC 1 parameter block. The status returned 
depends on the type of drive in use. See the 
High Performance Magnetic Tape System (HPMTS) 125 
Programming Manual for a list of the status 
halfwords. Requires hardware support. 


RESERVED 
10 ERASE TAPE - Erases a variable Length of tape, 


beginning at the current position. The length of 
tape erased is determined by the following formula: 


No. of Bytes in User Buffer 
Length of Tape Erased = --~--~-~---~----- 23 renee nee 


Current Tape Density 


t 

H 

{ 

| 

H 

| 

| 

| 

( 

| The result is rounded up to a multiple of the 

} length of a hardware gap (approximately 3 to 3.5 
i imches). The maximum number of bytes that can be 
| erased depends upon the tape density (See 

| Table 2-7). If an erase tape request exceeds the 

| maximum number of bytes for the current tape 

i Qensity, the OS will erase the maximum number of 

| bytes and then output a message indicating that the 
| remaining bytes in the buffer were not erased. The 
| erase tape function is illegal if the tape is at 

} Load point. 

' 


NOTE 


For device code 65, the current density 
is assumed to be 800BPI. If the current 
density for device code 65 is l1600BPI, 
the length of tape erased is twice as 
long as requested. 


RESERVED 


Cee i i re een eee ee ee 
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TABLE 2-7 MAXIMUM NUMBER 


OF BYTES 
ERASED 
| TAPE | 
! DENSITY | NUMBER } 
| (BPI) | OF BYTES } 
800 {| 200,000 | 
' 1600 ! 400,000 | 
| 6250 ! 1,000,000 | 


ede ened 


Table 2-8 contains the extended function codes available when the 
standard function code bit setting indicates a data transfer 
operation. 


TABLE 2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS 


a ne ee es ee ae ee ene nl RR Le NE nc Le io AN ee ae a ec SE RE CO ce ee Ue ND gS GT ee OY Ge gy MW mer onion Sami 


| ! 
' t 
| FUNCTION | 
CODE OPERATION/EXPLANAT ION 
0 NO EXTENDED FUNCTIONS 
The bit settings of the standard function (byte 
1 of the SVC 1 parameter block) are read and 
used to determine the operation to be performed. 
L READ BACKWARD 


' 
i 
| The tape drive will read previous records ona 
| tape while the tape is moved in the backward 
| (rewind) direction. The task buffer is filled, 
| from start address to end address, with bytes 

| im the order they are read; i.e., reverse. If 
} an error occurs during a read backward operat- 
i ion, the magnetic tape drive will perform re- 

| tries on that operation up to a number of times 
} corresponding to the value set in the sysgen 

| macro library. (The read bit of the SVC 1 

| function code should be set.) Requires hard- 

| ware support. 
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Resi 2- 


Celi mmeeticenee lien tl ene Maasai name tet celle Een a ie a te ene ee I ee ee en me rene ee ee ee ee 


EXTENDE 
FUNCTIO 
CODE { 


20 


2 


ee eee ew eee eee ee es ww a we eee ew ew me we ee ee ee ee ee we Oe we Oe Swe we woe Ce ww Ge we Ge we woe oe 
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8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS (Continued) 


OPERAT ION/EXPLANAT ION 


en ee ee ee 8 EG OE OS Oe RS Ee EE SE EE a ee eed 


GAPLESS OPERATION 


The driver reads or writes multiple data buf- 
fers to or from magnetic tape with no interrec- 
ord buffers gaps, using only one SVC 1. Gap- 
less operation requires the use of a special 
SVC 1 parameter block. The read or write bit 
in this parameter block should be set. Gapless 
operation is explained in Section 2.3. Re- 
quires hardware support. 


GAPLESS OPERATION WITH BUFFER TRANSFER REPORT- 
ING 


The driver reads or writes multiple data 
buffers to or from magnetic tape with no inter- 
record gaps, using only one SVC 1. The task 
receives a buffer trap each time the driver 
uses another buffer. Gapless operation re- 
quires the use of a special SVC 1 parameter 
block. The read or write bit in this parameter 
block should be set. Gapless operation is ex- 
plained in Section 2.3. Requires hardware 
support. 


READ FORWARD AND IGNORE DATA TRANSFER ERRORS 


The tape drive reads from the tape and ignores 
data transfer errors if encountered. If a data 
transfer error occurs, the status halfword is 
set to indicate normal completion of the read. 
The position of the tape after the read is the 
same as if no error had occurred. Since some 
errors terminate data transfer, the user should 
check the length of data transfer field to 
verify that all of the specified data was 
actually read. (The read bit of the SVC l 
function code should be set.) 


TABLE 2 


-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 


OPERATIONS (Continued) 


a em eet ne em nT nem eae mmo me tem ree oem emcees coco mmm em ees ee ere me ace eee ee meme ene te ene me eee ems ey OO mae cee ee ee em eee wine a 


EXTENDED | 
FUNCTION | 
CODE 


READ BACKWARD AND IGNORE DATA TRANSFER ERRORS 


The tape drive will read previous records ona 
tape while the tape is moved in the backward 
(rewind) direction and will ignore data 
errors if encountered. If a data error occurs, 
the status halfword is set to indicate normal 
completion of the read. The position of the 
tape after the read is the same as if no error 
had occurred. Since some errors terminate data 
transfer, the user should check the _ length of 
data transfer field to verify that all of the 
specified data was actually read. The user 
buffer is filled, from start address to end 
address, with bytes in the order they are read; 
i.e., reverse. (The read bit of the svc l 
function code should be set.) Requires hardware 
support. 


USER CONTROL OF RETRIES FOR DATA TRANSFER 
ERRORS 


If an error occurs during a data transfer oper- 
ation, the magnetic tape drive will repeat the 
operation up to the number of retries specified 
by the user in the first byte of the extended 
options field. The maximum number of retries 
that can be specified for a read operation is 
255. The maximum number of retries that can be 
specified for a write operation is 45. (The 
read or write bit of the SVC 1 function code 
should be set.) 


NOTE 
If extended function code 6 is not 
specified, the number of retries de- 


faults to the value set in the sysgen 
macro library. 
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TABLE 2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS (Continued) 


oem ab UO Se NNR SOE mem EU DOO SENEE NESE SR om UE “eres ene ee cm ee rem oem mV OE URN we eat DSM MOOD RR ME UNO mem cays ee Sem er we np Ste came i Smee wim rete eee SO od Sern Sema a 


EXTENDE 
FUNCTIO 
CODE OPERATION/EXPLANATION 


rarer ere rc te tI ce SS TS SSS SSS SSE SST SSE ST KS SK SI TS SESS KS SSE SS ST ST STITT SL TSS SSS SSR Se 


20 


7 READ BACKWARDS AND AIL.LOW USER CONTROL OF RE- 


TRIES FOR DATA TRANSFER ERRORS 


| The tape drive will read previous records on a 
i tape while the tape is moved in the backward 
| (rewind) direction. The user buffer is filled, 
i from start address to end address, with bytes 
i in the other they are read; i.e., reverse. If 
{ an error occurs, the magnetic tape drive will 
} repeat the operation up to the number of 
i retries specified by the user in the first byte 
i Of the extended options field. The maximum 
| number of retries that can be specified is 255. 
i (The read bit of the SVC 1 function code should 
i be set.) 


oe 


In both cases, extended function codes are mutually exclusive, 
that is, only one extended function code can be specified in a 
single SVC 1. 


2.2.7.3 Device Dependent Status Codes for Magnetic Tape 
Operations 


The device dependent and device independent status fields of the 
SVC 1 parameter block indicate the execution status of an I/0 
operation performed to a magnetic tape. Table 2-9 lists’ the 
status codes returned to these fields. Additional status codes 
for gapless I/O operations are listed in Table 2-12. A magnetic 
tape I/O operation will cease upon detection of most of these 
errors. 
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TABLE 2-9 MAGNETIC TAPE DEVICE DEPENDENT STATUS CODES 


CN Nee 


i STATUS 
| CODE 


8301 


8400 


84FB 


A000 


Cee ee Rage El meen edo Ry a ee en ee ee 
ace a a 2 rd dd 


Timeout - A read or write timeout condition occur- 
red during data transfer. 


Device write-protected - A write, write filemark, 
create gap, or erase tape operation was attempted to 
a write-protected device. 


Maximum buffer size exceeded - The buffer for the 
erase tape control operation is too large. 


Retries exhausted - A read, read backward, or write 
operation was retried the maximum number of times. 


Timeout - A control operation timeout occurred. 


Timeout - A read, read backward, read drive status, 
write or write filemark timeout condition occurred. 


Read backward at load point - Load point was reached 
before a read backward operation terminated. 


Timeout - A read, read backward, or write timeout 
condition occurred while waiting for a prior 
operation to be completed. 


Short read - The buffer specified was too small for 
the tape block. This status is only supported by 
the high performance tape systems. 


Bottom of tape/end of tape check malfunction - An 
error occurred during an attempt to position the 
tape to determine whether the beginning or’ end of 
tape was detected. 


SELCH malfunction - The SELCH malfunctioned during 
a read, read backward, or write operation. 


Retries exhausted for Write Filemark - A write 
filemark operation was retried the maximum number of 
times. 


Retry malfunction - An error occurred while attempt- 
ing to position the tape to retry a read, read back- 
ward, write, or write filemark operation that 
resulted in a recoverable error. 


Device unavailable - the device is either inopera- 
tive or not configured into the system. 
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TABLE 2-9 MAGNETIC TAPE DEVICE DEPENDENT STATUS 
CODES (Continued 


{and ee came PR SOO RE RAMEE REND CORRE) GREE MnP tee mR Pe mh OS RE rem GE es Summ mS te re sm Sam mS am ceeme Sette emt ey nem ADVE ee nem mee me meer oat Samm Sm komen a ate Am SOU rm erty nm HER ER Hm ete ome 


STATUS 
CODE 


C—O 


Illegal function - the function code indicated 


cooo0 


! 
| 
MEAN ING 


data transfer operation, but neither the read nor 


write bit was set. 


The function code indicated a control operation, 
none of the other bits in the function code 


set. 


The function code indicated an extended control 
operation, but the extended SVC 1 task option was 


disabled. 

The requested function is not supported by the 

device or assigned access privileges. 

Illegal extended function code - an undef ined 
the 

specified tape drive, was indicated. 

The extended function code indicated a read 

operation, but the standard function code has’ the 

write bit set. 

Buffer size too small - the buffer for a read, read 


backward, or write operation was less than 4 bytes. 
The buffer for the read drive status was) smaller 


than 16 bytes. 


Erase tape at load point - an erase tape operation 


was attempted when a tape was at load point. 


User retries too large - the maximum number 
retries specified for a write operation was’ greater 


than 45. 
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but 
were 


of 


| function, or a function not’ supported by 
5 
! 
H 
H 
H 
H 
H 
H 
i 
H 
} 
H 
H 
| 
| 
\ 
{ 


a 


meee eee ee wees ee ee eee eee eee eo ee we ee eww we Bem we we! ewe == 


2.3 GAPLESS INPUT/OUTPUT (I/0) OPERATIONS 


Data transfer operations in gapless mode consist of a task 
reading or writing data to or from a magnetic tape with no 
interrecord gaps, using only one SVC 1. A task can have only one 
ongoing gapless SVC 1 at atime. The format of a gapless' mode 
SVC 1 parameter block differs from the standard SVC 1 parameter 
block. The gapless SVC 1 parameter block cannot be reused until 
the gapless operation has been completed. To perform a gapless 
I/O operation, the XSVC1 Link option must be specified before an 
I/O request is issued. Then, the task must issue an SVC l call 
that specifies, among other things, a pair of buffer queues, the 
IN-QUEUE and the OUT-QUEUE. The driver takes buffers from the 
IN-QUEUE and returns used buffers to the OUT-QUEUE. The task 
processes the buffers from the OUT-QUEUE and returns these 
buffers to the IN-QUEUE for reuse by the driver. 


The use and reuse of buffers during gapless I/O enables an amount 
of data much greater than memory capacity to be transferred by 
breaking the data into smaller segments, and then transferring 
these small segments of data sequentially. The gapless mode SVC 
l parameter block can only be used for gapless I/O operations. 


2.3.1 Gapless Mode Supervisor Call 1 (SVC 1) Parameter Block 
Format 


The gapless mode SVC 1 parameter block must be 24 bytes long, 
fullword boundary aligned, and located in a task writable 
segment. Location within a task writable segment is necessary so 
that the status of an I/O request can be returned to the status 
fields of the SVC 1 parameter block. Figure 2-5 presents the 
gapless mode SVC 1 parameter block and coding example. 
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1(1) ' 122) Device 


10(0 Function | i3(3) Devic 
Code lu i independent dependent |; 
{ H H status status 
H a a ts ms li ms “Sans bt eh mm Sa a hn’ me Cs mes ee es es sic ce Sa cans Ss ae ae ea ac Paani IAS ht a a ace a : 
14(4) | 
{ OUT-QUEUE start address | 
t ' 
ee eee ee rere em eee Sere eee | 
18(8) | 
IN-QUEUE start address 
! ’ 
re See eens eee ee mee | 
{12(C) | 
H Buffer length 
' ‘ 
bei eae Eh oats See iia aa eer eee eer ee ee , 
116(10) ! 
{ Length of last buffer 
' ' 
er ne en ee ee eee Te eee ! 
120(14) 
{ Extended options 

SVC 1,parbl1k 

ALIGN4 

parblk DB x'function code' 

DB x'lu' 

DS 2 bytes for status 

DC A (OUT-QUEUE buffer start address) 

DC A (IN-QUEUE buffer start address) 

DS 4 bytes for buffer length 

DS 4 bytes for length of last buffer 

Y 


‘extended options' 


Figure 2-5 SVC 1 Gapless Mode Parameter Block Format and Coding 


48-038 FOO ROL 2-33 


Fields: 


Function 
code 


lu 
Device 


independent 
status 


Device 
dependent 
status 


OUT-QUEUE 


IN-QUEUE 


Buffer length 


is a 1-byte field indicating that the request 
is a data transfer request, the specific 
operation to be performed (read or write), and 
the extended options pointer. Bit settings 
for this field are presented in Table 2-8. 


is a l-byte field containing the logical unit 
currently assigned to the device where the I/0 
request is directed. 


is a l-byte field receiving the execution 
status of an I/O request after completion. 
The status received is not directly related to 
the type of device used. Table 2-3 presents 
device independent status codes for gapless 
operation. 


is a l-byte field receiving the execution 
status of a gapless I/0 request after 
completion. The status received contains 
information unique to the type of device used. 
Table 2-11 presents device dependent status 
codes for gapless operation. 


is a 4-byte field containing the fullword 
address of a queue where the driver places the 
starting address of each buffer used ina 


gapless [I/O operation. If the operation is a 
gapless write, these buffers have been 
successfully written to tape. If the 


operation is a gapless read, these buffers 
contain data read from the tape. 


is a 4-byte field containing the fullword 
address of a queue where the task places the 
starting address of each buffer to be used in 
a gapless I/O operation. If the operation is 
a gapless write, these buffers will be written 
to tape. If the operation is a gapless'7 read, 
these buffers will be filled with data read 
off from a tape. 


is a 4-byte field containing the length of 
each buffer whose starting address is present 
on the IN-QUEUE. Buffer length must be an 
even number of bytes for both read and write 
operations. All buffers, except the last, 
must be the same length within ae single 
gapless [I/O operation. However, the amount of 
space used in the last buffer may vary. 
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Length of 
last buffer 


Extended 
options 


is a 4-byte field whose contents depend upon 
the operation (read or write) being performed. 
If the operation is.a gapless read, the driver 
fills this field with the length of the _ last 
buffer read off tape. The length of the last 
buffer may be optionally supplied by the task. 
If the operation is a gapless write, the task 
supplies the driver with the length of the 
last buffer to be written. 


is a 4-byte field containing one of two 
possible extended function codes’ indicating 
gapless mode I/O. Table 2-12 presents the 
extended function codes available for gapless 
mode I/O. 


2.3.2 Standard Function Code Format - Gapless Mode 


Figure 2-6 shows the standard function code format for a gapless 


mode 


code bit setting. 


data transfer request, and Table 2-8 defines each function 


Extended 
Option 
FetiN 
iO; Ri Ww yj H i H { 
Bits 
0 1 2 3 4 5 6 7 


Figure 2-6 Function Code Format for Gapless Mode Data Transfer 
Requests 


TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS 


Ci A Te ee 


BIT H 
POSITION } 


NAME BIT SETTING AND MEANING 


Seer KSe Sess SSS SSS RTS KS Se KS K VI SST VS SSS FST BM Sr SetT EVs SVT SS SET STIS SSS SI SE VS ST TST ST TS H 

0 | Function code | O = data transfer request. Must |} 

| type { be set for gapless I/0 

H operations. 

sna sce lp Sit. Smit een’ oes Sn Na a tn" bh“ (sc “ni i) ab mass oc“ cima omni tem Son, eum “ca a mh cs na Ym re er { 

1 | Read | 1 = read operation. (Bit 2 H 

H H must be set to 0.) H 

fos a a! cc nk ch ems aml Yn es Sema cla "mm “va secs ime “i imines “Ss cma onc mom mewn a“ ma ase eto Ss i 
2 i Write 
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| L = write operation. (Bit l 
H must be set to 0.) H 


ee mone 


ee ie we we i ee eee ee i ee ee ee ee ee ee ee eee ee oe 


TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS 


(Cont inued) 


I 


BIT BIT 
{ POSITION | NAME 
H Pee ee ee ee Ee eS ee ee ee 
3 i Not used in 
| gapless mode 
‘ . 
i 
i 4 | I/O proceed 
i 
i 
ij Wait I/O 
i 
i 
| 1 
| 4 
i | Wait only 
i 
1 ! 
/ t 
i 
j i 
j 
i 
i 
i 
i 
i 
j 5 | Not used in 
H } gapless mode 
t 
{ 
6 Conditional 


2-36 


proceed 


BIT SETTING AND MEANING 


Ce ee ee ee ee 2 ee 2 ee ee 2 


mee ee aR ne stm TR cE mE SRD A TRY ONY remy ns ames ming MY mS eSATA AO em CRY Vm cee em ese com mY AS me men me sie RO I me min RO 


If the device is not busy, 
return control to the call 
ing task after initiation 
of data transfer to the 
device. However, if the 


device is busy, the request 


is queued and task execu- 
tion continues. Suggested 
for gapless mode. 


stop task execution, ini- 
tiate data transfer to the 
device, and wait until the 
completion of I/O. 


task execution stops and 
waits until the completion 
of all queued I/O proceed 
requests to the specified 
lu. 


When a wait only request is 


issued, bit 4 is the only 
bit set in the function 
code. 


Cee ee ee en ee es ee ee ee ee es es Se 


eee eticeeeetitrcertienetiiaerediicceerti tenet Ree Re I I ee ee 


after the I/O request is 


issued, put the task intoa 
wait state if the requested 


device is busy and the 
total number of queued re- 
quests exceed the maximum. 
Once the 1/0 request is 


completed, the task resumes 


execution. If the maximum 
number of queued requests 
is 1, a pending request 
causes the task to be 
placed into a wait state. 
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TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS (Continued) 


BIT H BIT H 

POSITION | NAME 1 BIT SETTING AND MEANING 
Unconditional { Ll = any I/O request made to a 
proceed device that is busy is re- 
jected if total number of 
queued requests exceed the 
maximum, and task execution 
continues. 


l = test to check for the com- 
pletion of I/O to a speci- 
fied lu. 


Test I/O 
complete 


If a previous I/0 proceed 
request or queued I/O pro- 
ceed request does exist, 
the condition code is set 
to X'F'. However, if there 
is no outstanding [I/O pro- 
ceed request, the condition 
code is set to X'O'. 


When a test I/O complete 
request is issued, bit 6 is 
the only bit in the func- 
tion code set. If bit 4 is 
set, it is PgnOree: 

exeended option ; 1 = pacee to see if XSVC1 

i option was specified at 

H Link time. If set, the 

i extended options fullword 

{ in the parameter block is 
' 

. 

| 

| 

{ 


checked for specified gap- 
less option. Both the 
XSVC1l option and this bit 
must be set for gapless 
operation. 


i a ie eee et eel tadied 


2.3.3 Logical Unit (lu) 


An lu is a decimal number ranging from O through 254. The 
highest lu number that a task can be assigned to is determined by 
the Link OPTION command. After loading the task into memory, the 
lu must be assigned to a tape drive which supports gapless I/0 
(device codes 68-70) through SVC 7 or an ASSIGN command. If no 
actual I/O operation is desired, the lu should be assigned to 
NULL:, causing a no-operation (no-op) to occur. 


48-038 FOO ROL 2537 


2.3.4 Device Independent Status Codes 


Logical units provide device independent I/O by causing all I/0 
requests to be made directly to the lu and not to the device. 
The execution status of a gapless I/O request that is independent 
of the physical characteristics of the device being used is 
returned to the device independent status field of the parameter 
block. See Table 2-3. The data remaining in this field from a 
previous I/O request is not modified until a subsequent I/0 is 
completed or an error occurs. 


2.3.5 Device Dependent Status Codes 


The device dependent status field, together with the device 
independent status field, indicates the execution status of a 
gapless I/O request that is directly related to the unique 
characteristics of the device being used. Tables 2-9 and 2-11 
presents the error status codes for gapless operation. A gapless 
operation will cease upon detection of any one of these errors. 


TABLE 2-11 MAGNETIC TAPE DEVICE DEPENDENT STATUS CODES 
(GAPLESS ONLY) 


Ene ee ee ee ee 


bytes. Length of last buffer is an odd 
number of bytes for a write operation. 


See om ee ee ee OR OS ne co ED RE SO RO em Ce SR SE ee me em Gey my ee mee eee SE OND ed ome mote ne oe oe mie wees oe 


| STATUS | i 
i CODE | MEAN ING H 
| X'8485'{| Read/write timeout - A read or write time- | 
} ; out condition occurred. { 
' ' I 
{ I f 
| X'8487'{| The end address read/written by the SELCH | 
| does not match the expected end address. H 
} i rf 
t t f 
| X'8489'| End address returned from SELCH is greater | 
i than the expected end address on gapless Hl 
| read. H 
I t ' 
t { { 
t ' t 
i X'CO81L'; No buffer is available on the task IN- { 
| QUEUE. 
( i { 
t t ' 
| X'CO82';} Address provided by user on IN-QUEUE is H 
H } outside user's address space. H 
' ' { 
| t ' 
| X'CO83'{ Address of a queue is not ona fullword H 
| boundary. 
! 1 | 
1 f 1 
i X'CO84'; Length of buffer is an odd number of H 
! ‘ f 
! ! 
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2.3.6 Buffer Queues 


The OUT-QUEUE field and IN-QUEUE field are each 4-byte fields 
that contain the address of a queue, where: 


@ the driver places the starting address of each buffer used in 
a gapless operation (OUT-QUEUE); 


e the task places the starting address of each buffer to be used 
in a gapless operation (IN-QUEUE). 


The address of the IN-QUEUE must be greater than the address of 
the OUT-QUEUE or the SVC 1 handler will reject the operation. 
Figure 2-7 presents the format of both the OUT-QUEUE and 
IN-QUEUE. 


The user sets up a queue via the DLIST xx command, where xx is 


the total number of buffer entries allowed. See the Common 
Assembly Language/32 (CAL/32) Reference Manual for instructions. 


ee 


10(0) i2(2) 
H Number of slots | Number used H 
i { § 
De eh oes te ed Se gas oe eee | 
14(4) 16(6) | 
H Current top H Next bottom 
' { ! 
' ‘ t 
| i es i es i "cm al i “mi win’ Ss ewes «Fm ag! asi Cp esto Se lS) See ea) Sn Sm cla im" Pen sn ose ota Gus en am. Smet as Sd Sc es H 
18(8) 19(9) ! 
| Flags { Address of first buffer 
J } i 
a ee | 
112(C) 113 (D) | 
H Flags H Address of second buffer H 
’ 1 I 
ee Fare ere ee eee are ! 
116(10) {17(11) 
H Flags H Address of third buffer 
t t : ‘ 
Gehl a a yeah lca fa rhe rR, AR itt ata a 
A NA 
“w ; Za 
t - I 
[MRR etnee See oS aaar ae sae ts eS ear anter aes omas | 
i 
Flags Address of nth buffer } 
‘ 1 { 
( { ’ 


CN i re cee ae een eel ane nelle 


Figure 2-7 IN-QUEUE or OUT-QUEUE Structure 
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Fields: 


Number of 
slots 


Number used 
Current top 
Next bottom 


Flags 


Address of 
nth buffer 


These fields are standard list parameters 
explained in the Common Assembly Language/32 
(CAL/32) Reference Manual. 


is a l-byte field. The setting of bit zero in 
this field identifies whether the buffer is 
the last buffer in the list. If bit zero is 
set to 0, the buffer is not the last buffer. 
If bit zero is set to 1, the buffer is the 
last buffer in the queue. Under abnormal 
conditions, the last buffer on the out-queue 
may not have the flag bit set. 


NOTE 


To properly terminate a gapless 
write operation, the flags field 
for the address of the last buffer 
to be written should have bit zero 


set to 12 A gapless read 
operation may be terminated in one 
of two ways. If the user wishes 


to only read part of a record, or 
the user knows how long the record 
is, the flags field for the 
address of the last buffer read 
should have bit zero set to l. If 
the user wishes to read the entire 
record, but does not know how long 
it is, the flags field for the 
address of all buffers should have 
bit zero set to 0. In this case, 
it is mandatory for the user to 
retain buffers on the _ in-queue 
until the I/O proceed has been 
completed. If exactly the number 
of buffers needed is placed on the 
in-queue, the last buffer must be 
so indicated. 


is a 3-byte field containing the hexadecimal 
starting address of a buffer. 
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2.3.6.1 Using the Buffer Queue 


Gapless operations should be specified as I/O proceed completion 
operations; therefore, task execution can continue during gapless 
I/O. One of the functions a task can perform during gapless I/0 
is to prevent the task from running out of buffer space. The 
task can accomplish this by removing buffer entries from the 
OUT-QUEUE and placing them on the IN-QUEUE after a buffer 
transfer is completed. For example, if a task is required to 
write 440kb in gapless mode using only five 64k buffers, the 
total buffer space available is 320K bytes (or 120K bytes less 
than is required to complete the write operation). After the 
first buffer has been written, the starting address of the buffer 
will be placed on the OUT-QUEUE. While the second buffer is 
being written, the task can transfer the address of the first 
buffer from ‘the OUT-QUEUE to the IN-QUEUE. This gives the task 
64K bytes more buffer space. 


Similarly, the task can transfer the address of the second buffer 
to the IN-QUEUE while the third buffer is being read. This 
transfer provides the task with enough buffer space for the 
remaining 56K bytes. Note that when the task transfers’ the 
address of the second buffer from the OUT-QUEUE to the IN-QUEUE, 
the zero bit of the flags field should be set to l. The length 
of the last buffer should be placed in the LENGTH OF LAST BUFFER 
field of the SVC 1 parameter block prior to the start of the 
operation. 


The task should use an ABL instruction to add buffer entries to 
the IN-QUEUE and an RTL instruction to remove buffer entries from 
the OUT-QUEUE. See the Common Assembly Language/32 (CAL/32) 
Reference Manual for more information on how to use the ABL and 
RTL instructions. 


2.3.6.2 Trap-Causing Events Resulting from Gapless'9 Input/Output 
(1/0) Operations 


Because a gapless I/O operation should be specified as an I/O 
proceed completion operation, the task can be notified that a 
gapless read or write has been completed via a task queue trap. 
If the SVC 1 extended function code 3 (gapless I/O with buffer 
transfer reporting) has been specified, the task can also receive 
a task queue trap each time a buffer address has been added to 
the OUT-QUEUE. 


Before a task can be notified of gapless I/O completion or a 
buffer transfer, the task has to _ be prepared to receive and 
handle a task queue handle trap. See the Application Level 
Programmer Reference Manual for information on preparing a task 
to handle traps. 
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2.3.7 Buffer Length 


The buffer length field is given to the driver by the task to 
inform the driver of the length of the buffers whose starting 
addresses are on the IN-QUEUE. Buffer length must equal an even 
number of bytes for both read and write operations. All buffers 
must be of the same length with the possible exception of the 
last buffer. See Section 2.3.8. 


2.3.8 Length of Last Buffer 


The use of this field is dependent upon the gapless I/O operation 
being performed (read or write). The length of this buffer 
cannot be greater than that of the other buffers. If a gapless 
write operation is being performed, this field will be given to 
the driver by the task and contains the length of the last buffer 
to be written. This information must be given even if the last 
buffer is the same length as the previous buffers and should be 
placed in the SVC 1 parameter block before the write is started. 


On a gapless read operation, the driver fills this field with the 
length of the last buffer read from the tape. For example, if a 
150kb record is to be read gapless from a tape and 64kb buffers 
are used, a total of three buffers will be required. The first 
two buffers will contain 128kb of information; however the third 
buffer will contain only 22kb of information. The value 22kb 
will be returned to the length of last buffer field in this 
example. If desired, this field may be given to the driver by 
the task. If the last buffer is specified for a read; i.e., the 
flags field of the address has bit zero set to l, this field must 
be given to the driver by the task. 


NOTE 


If a gapless read does not reach a normal 
completion (status code 0), the contents 
of the length of last buffer field are 
meaningless. 


On a gapless write operation, the length of the last buffer must 
be an even number of bytes. 


2.3.9 Extended Options Field 


The extended options field in a gapless mode SVC 1 parameter 
block functions as detailed previously in Section 2.2.7. 
However, only two extended function codes are recognized as valid 
in a gapless mode SVC l. These codes are presented in Table 
212. 
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TABLE 2-12 EXTENDED FUNCTION CODES FOR 
GAPLESS 1/0 OPERATION 


| EXTENDED | 

i FUNCTION |} 

H CODE | OPERATION 

| HSE Se Kee ESR ES SS EE eee See SS SS SSS SSS ESSE = 
H 2 | Gapless operation 

' ! 

t ' 

H 3 | Gapless operation with 

| ! 

' ‘ 


TQ 


uffer transfer reporting 


a SS SE LY ES ES MN OE SY a a SE I ee me SS a DD GeO EE alae haem em Ne cet es ee 


Codes O-1l and 4-31 are not used with the gapless 


parameter block. 
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mode SVC 1 


CHAPTER 3 
GENERAL SERVICE FUNCTIONS SUPERVISOR CALL 2 (SVC 2) 


3.1 INTRODUCTION 


SVC 2 provides general service functions distinguished from _ one 
another by a specific function code number. Each SVC 2 function 
requires a specific parameter block for proper operation. Refer 
to each individual code for its parameter block format and 
required coding. Table 3-1 lists all available SVC 2. function 
codes with a brief description of each. 


TABLE 3-1 SVC 2 FUNCTION CODES 


ee ee ee ee ee ee ee ee ee 


SVC 2 CODE jj NAME 1 FUNCTION 


executive task (e-task). 


| Re RE Ee SS Ee See ese | 
| SVC 2 code 0*{ Make journal i Makes an entry into the 
i i entries i system journal from an 
! ) t 
! ! ! 

5 


Places the task in a 


a 
S 
Q 
S 
ie) 
~ 
Qs 
ie) 
Q 
] 
ct 
» 
cr 
0) 


} Reserves a workspace area 

i in the task's address space 

| for external subroutines 

i called by the task during 

; execution. 

Release storage Releases’ the temporary 
storage locations obtained 
by a previous SVC 2 code 2. 


the task UTOP by the 
number of user-specified 
bytes. 

Set status i Modifies the arithmetic 
i fault interrupt bit and 

i; condition code in the 

} program status word (PSW). 


| 
i Gets storage by decreasing 
1 
7 
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TABLE 


3-1 SVC 2 FUNCTION CODES (Continued) 


on a a RE AR ne OP eee a em ee mm ce ce ee meee ee eee gee ee ee ee ee ee ee oe ee ere eee ee oe ee ee ee 


ms eee meee ee a ee ee ee ee we we 


—— ee eee ee ee ee ee ee ee 


SVC 2 CODE 


sass ea SS SS SE SS SS 


SVC 2 code 5 


NAME 


Sess es Se SE SS SSF SSIS SS SS SS SSS SSS SS SS SS ST SES SS SSS SS STS SS CS ST ES ! 


Fetch pointer 


Convert binary 
to ASCII 
hexadecimal or 
ASCII decimal 


Interrogate 
clock 


wait 


Convert ASCII 

hexadecimal or 
ASCII decimal 

to binary 


FUNCTION 


Copies the address of UTOP, 
CTOP, and UBOT from the 


task control block (TCB) and 


stores them in the task 
user dedicated location 
(UDL) . 


eee ce ee ee me ee ee ee ae SD SO ER eae a SY ce SU GD Ge eee SE ane cw ee ee ED ee De es ie ER eS ce eee en eee me 


Converts a binary number to 
either an ASCII hexadecimal 


or ASCII decimal number. 


me mers Se ere aL SY ae FD tee PSY sm eA GE ENA NE ED SRY ESOS Sy SRY ae SS EDS SED ae eS eS DE ar eS GD RO GO te mm ky ED mH foe LD one 


Sends a message to the 
appropriate log device 
regardless of the current 
logical unit (lu) assign- 
ments. 


Ce Ee ii ee erate ee eel ane hee Merl el ee hee ene ne 


Sends the user the current 
time of day calculated in 
seconds from midnight in 
binary or in formatted 
ASCII. 


Ce eee ee ee dd ee ee ee ee es ee ee 


Sends the user the current 
date in formatted ASCII. 


Places the calling task in 
a wait state until a 
specific time of day. 


ce eee RT gD RO ES ED NY SE em RO Se SOT RG a SE SR my GY SD ES RE cm cee OH ee Ee ee ee ee ne ee Sl 


Places the calling task in 
a wait state for an 


interval, which is specified 


in milliseconds from the 
time the call is executed. 


Caticnealiome tami anand nee cme enema li ee sen Ae hee Re Ree ee ee en nnn ecole dete Me ee ee 


Allows a foreground task 
loaded from the system 
console to invoke operator 
and CSS commands. 


Converts an ASCII hexa- 
Gecimal or ASCII decimal 
number to a binary number. 
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TABLE 3-1 SVC 2 FUNCTION CODES (Continued) 


Ce AN ee Nc ee an te A ee ee enn een ee ee 
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descriptor 


Scan mnemonic 
table 


Move ASCII 
characters 


Expand alloca- 
cation 


Contract alloca- 
tion 


Timer 
management 


SVC 2 CODE. |} NAME H FUNCTION 
SVC 2 code 16} Pack file {| Processes a user-specified 


unpacked file descriptor 
(fd) into a packed format to 
be used by the operating 
system. 


Scans for an ASCII character 
string in amnemonic table 
and compares it with the 
user-specified ASCII charac- 
ter string for a match. 


Oey ee ie A es SO eS ce ee SD ee cee me ae ee me ee em cee meee me me cme ee eee ces enti ee  e  me See  te Se me mee 


Moves a specified number of 
ASCII characters in memory 
from the sending location to 
a receiving location. 


ec oem MRS mney UU mn emt ON te atm pe SOUND nave trem mmem TUG SOD mty ety erm AGED US nm SEDC em me wey SU mem mem ete ee ee mee, em me ee my ee ee ey Ae ee em ee Sete me mt me em ein ee ne 


Obtains user-related infor- 
mation from operating system 
Gata structures. 


Reserved for sequential 
tasking machines. Provides 
for compatibility with 
current 32-bit operating 
systems. 


om nem ee me ee ce ce cee ee ee ee ees ee ee ee ee eee ee me ne ee re ee eee ee rm ee ee ee ee en ee ee ee 


Reserved for sequential 
tasking machines. Provides 
for compatibility with 
current 32-bit operating 
systems. 


I I I I a a Dee ae eee eee ane 


Schedules the addition of a 
parameter to a task queue on 
completion of a specified 
interval or a repetitive 
interval. 


Puts a task in a wait state 
until completion of an 
interval. 


Determines the time remaining 


for a previously established 
interval to expire. 


Cancels a previously 
established interval. 


we eee ee ae oe ee ie ew we we oe 


TABLE 3-1 SVC 2 FUNCTION CODES (Continued) 


ae make ce es ee Rae mn ne et Sn SS ree wee eee eS ues we om cee em eee eS ee ce te eee ee ee ee ee ee 


SVC 2 CODE | NAME { FUNCTION 
SVC 2 code 24} Set i Stores eight bytes of user- 
| accounting supplied information in the 


t 
1 
I i] 
| information {| accounting transaction file 
{ i (ATF) on task completion or 
| { Gata overflow of accounting 
H {| records. 
| hie 0 Shs, lm: ia Si i “eg: ln: a. psn ‘i api hl i "miss a eh: es, ue: Se et. ithe: nei “inet tp ils nai: 
| SVC 2 code 25] Fetch | Fetches accounting informa- | 
H | accounting i tion and stores it in | 
H | information } a user-specified receiving } 
H i i area. H 
leaieicat ian ae Ss 4a Sek Ga eC SRR Ee 
i; SVC 2 code | Fetch device } Searches the volume mnemonic | 
| 26* | name | table for a user-supplied H 
| H i volume name and returns the | 
' H { name of the device on which } 
{ H i that volume is mounted. H 
5a nts o/s ss sn srk nao ioe ues ann“ sy em Vem “i ice inc“ Le "ww" ea bn“ ih ind tp ams es es Galen es mi “en ig cn ins ssn ei tei’ | 
SVC 2 code Memory manage- Allows a user task (u-task) 
27* ment to access and modify entries 


the private segment table 
(PST) in its task control 
block (TCB). 

Unpack file i Converts a packed file 
descriptor (fd) {| descriptor (fd) from the 

i file directory or an SVC 7 
4 

: 


{ 
H 
{ (except shared ones) within 
i 
| 
H 


parameter block to its un- 
packed format. 


lc an tate ahaa ee eel ee Dl ee ne eel eee ee ae cee ee ne en ele ee 


we we wee ee ee 
we aes ee ae oe 


LEGEND 


* indicates SVC is documented in OS/32 System Level Programmer 
Reference Manual. 
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3.2 SVC 2 CODE 1: PAUSE 
SVC 2 code 1 stops task execution and places the task into a 


suspended state. This is accomplished through the SVC 2 code 1 
parameter block shown in Figure 3-1. 


SVC 2,parblk 


ALIGN 4 
parblk DB 0,1 


Figure 3-1 SVC 2 Code 1 Parameter Block Format and Coding 


This parameter block must be 2 bytes long, fullword-boundary 
aligned, and does not have to be located within a task writable 
segment. Following is a description of each field in the 
parameter block. 


Fields: 
Option is a l-byte field that must contain a value of 
0 to indicate no options for this call. 
Code is a l-byte field that must contain the 


decimal value 1 to indicate code 1 of SVC 2. 


After executing SVC 2 code 1, the following message is displayed 
on the system console: 


TASK PAUSED 
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If the task is running under the multi-terminal monitor (MTM), 
the above message is displayed on the user console. 


While the task is paused, the operator can issue commands 
directed to the paused task to change the task environment. To 
continue task execution, enter the CONTINUE command. Task 
execution resumes with the instruction immediately following SVC 
2 code l. 
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3.3 SVC 2 CODE 2: GET STORAGE 


SVC 2 code 2 reserves a workspace area for external subroutines 
called by the task during execution (e.g., FORTRAN run-time 
library (RTL) routines). This workspace is reserved in the 
unused portion of the tasks impure segment between UTOP and CTOP. 
For more information on this segment, see the OS/32 Application 
Level Programmer Reference Manual. 


The SVC 2 code 2 operation does not increase the task's allocated 
memory size. 


Figure 3-2 illustrates the parameter block for the SVC 2 code 2. 


a eS SS a SE mS Se ee COS eS PA GUD EES SOD GOD GY We Su me mE cy me mee eee ee ee eee nem me ee en ee eee eee ee ee ee ee ee 


10(0) f1(1) i2(2) i3(3) 
H Option H Code H Reserved {| User register} 
ee ee ee ee ee eae 
| 4(4) ! 
i Number of bytes 
SVC 2,parblk 
ALIGN 4 
parblk DB option,2,0 
DB user register 


DC F'number of bytes' 
Figure 3-2 SVC 2 Code 2 Parameter Block Format and Coding 
This parameter block must be 8 bytes long, fullword-boundary 
aligned, and located in a task writable segment when option X'80' 


is used. A general description of each field in the parameter 
block follows. 
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Fields: 


Option is a l-byte field that must contain one of the 
following options: 


e Option X'00' reserves the user-specified 
number of bytes in fullword increments in 
the unused portion of the task impure 
segment between UTOP and CTOP. 


e Option X'80' reserves all of the remaining 
unused portion of the task impure segment 
between UTOP and CTOP. 


Code is a l-byte field that must contain the 
decimal value 2 to indicate code 2 of SVC 2. 

Reserved is a reserved l-byte field that must’ contain 
a zero. 

User is a l-byte field that must contain a decimal 

register number ranging from 0 through 15. specifying 


the register to receive the starting address 
of the reserved workspace area. 


Number is a 4-byte field containing different 
of bytes information for each option. 


e Option X'00' contains the user-specified 
number of bytes to be reserved for the 
workspace area. 


e@e Option X'80' receives the number of bytes 
actually reserved for the workspace area. 


When a task is link-edited, the default task workspace (the 
adifference between CTOP and UTOP) should be large enough to 
provide enough workspace for both the task and the external 
subroutines. The task workspace can be increased through the 
WORK= parameter of the Link OPTION command, the LOAD command, or 
an SVC 6. 
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After executing SVC 2 code 2, the condition code is set as 
follows: 


Condition codes 


i;cl}viGcgitL 
; Oo}; O {| O {| O } Normal termination 
{ 


;O} 140 4}; O | User-specified number of bytes is a 
Sa rac ec rls negative value or a value greater than 
the task's allocated memory size. 


NOTE 


When SVC 2 code 2 is executed, and the 
task UTOP changes, the UTOP address 
stored in the task UDL is not updated to 
contain the most current UTOP. SVC 2 
code 5 updates the address in the UDL. 


3.3.1 SVC 2 Code 2, Option X‘'00' 


If option X'00' is specified, the address of the task's current 
UTOP is adjusted to include the number of user-specified bytes in 
the parameter block. Once the UTOP address is adjusted, the 
starting address of the reserved workspace area, which is’ the 
original or previous UTOP, is stored in the user-specified 
register. This option can reserve new workspace areas until they 
are needed during task execution in subsequent calls. 


The number of bytes should be specified in fullword increments 
because the UTOP address is rounded up to the nearest fullword 
boundary. 


Example: 
SVC 2,GET 
ALIGN 4 
GET DB 0,2,0 
DB 5 
DC ¥'600' 1.5K 


This example is illustrated in Figure 3-3. A task is loaded with 
a task workspace area of 4kb specified in the LOAD command. 
After the task is loaded, UTOP is located at X'AOO' and CTOP is 
located at X'19FE'. After executing SVC 2 code 2, UTOP is 
adjusted to X'1000'. The remaining unused portion (area between 
X'AOO' and X'1A00') can be used by subsequent routines’ when 
needed during task execution. 
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If the user-specified number of bytes for option xX'00' is a 
negative value or greater than the task current allocated memory 
size (CTOP): 


e The UTOP address is not adjusted. 


e An address of O is returned in the user-specified register. 


@® The condition code is set to 4 (V bit set). 


5630 


EXPANDED THROUGH 
WORKSPACE FIELD OF 


X‘1A00' LOAD COMMAND 
(ABOVE USER 
TASK) X'19FE' CTOP 
(AFTER LOAD TIME) 
UTOP X‘1000' 
(AFTER SVC 2 4kb 


CODE 2 EXECUTION) 


X‘600' BYTES 
(RESERVED BY 
SVC 2 CODE 2) 


CON (BEFORE LOAD TIME} 


USER CODE 


x'100' 


UBOT X’‘0' 


NOTES 


UTOP is the starting address of the first 
contiguous fullword outside the user 
code. ° 


CTOP is the starting address of the last 


halfword within the allocated task 
address space. 


Figure 3-3 Task Impure Segment for SVC 2 Code 2, Option X'00' 


# 
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3.3.2 SVC 2 Code 2, Option X‘'80' 


If option X'80' is specified, the parameter block must be located 
in a writable segment. The address of the task's current UTOP is 
adjusted to include all of the remaining unused portion in the 
impure segment making UTOP equal CTOP+2. Once the UTOP address 
is adjusted, the starting address of the reserved workspace area, 
which is the address of the original or previous UTOP, is stored 
in the user-specified register. Also, the number of bytes 
actually reserved is stored in the number of bytes field in the 
parameter block. 


Example: 
SVC 2,GET 
ALIGN 4 
GET DB X'80',2,0 
DB 5 
DS 4 


This example is illustrated in Figure 3-4. A task is linked with 

a workspace of 4kb. After the task is loaded, UTOP is located at |} 
X'AOO'. After executing SVC 2 code 2, UTOP is adjusted to 
X'1900'. 
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5631 
UTOP X‘1900' 


(AFTER SVC 2 
CODE 2 EXECUTION 


X'FOO’ BYTES 


UTOP X‘A00' 


USER CODE 


X‘100' 


UBOT X’0' 


NOTE 


EXPANDED THROUGH 
THE LINK OPTION 
COMMAND 


X‘18FE’ CTOP 
(AFTER EXPANSION 


BY LINK) 


X‘E00’ BYTES 


X'AFE' CTOP 
(BEFORE EXPANSION 
BY LINK) 


UTOP is the starting address of the first 


contiguous fullword outside the 
code. 


CTOP is the starting address of the 
halfword within the allocated 
address space. 


user 


last 
task 


Figure 3-4 Task Impure Segment for SVC 2 Code 2, Option X'80' 
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3.4 SVC 2 CODE 3: RELEASE STORAGE 


SVC 2 code 3 releases the workspace area in the unused portion of 
of the task impure segment that had been reserved by a _ previous 
SVC 2 code 2 (See Section 3.3). Releasing the reserved workspace 
for external subroutines does not decrease the task's allocated 
memory size. The SVC 2 code 3 parameter block is shown in Figure 
325. 


10(0) {1(1) 12(2) 
{ Option i Code H Reserved { 
i 
isp seat e tec ee eae a aso rasa seataer Seer Sr eee | 
14(4) 
| Number of bytes H 
i ; J 
§ t 

svc 2,parblk 

ALIGN 4 

parblk DB 0,3 
DC H'O' 


DC F'number of bytes' 


Figure 3-5 SVC 2 Code 3 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 


and does not have to be located in atask writable segment. A 
description of each field in the parameter block follows. 


Fields: 
Option is a l-byte field that contains a value of 0 
to indicate no options for this call. 
Code is a l-byte field that must contain the 


Gecimal value 3 to indicate code 3 of SVC 2. 
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Reserved is a reserved 2-byte field that must contain 


zeros. 
Number is a 4-byte field that must contain the 
of bytes user-specified number of bytes of the reserved 


workspace to be released. 


When executing this SVC, the address of the task's current UTOP 
is adjusted to exclude the user-specified number of bytes of 
reserved workspace. If the number of bytes is not specified in 
fullword increments, the UTOP address is adjusted by rounding 
down to the nearest fullword boundary. After executing SVC 2 
code 3, the condition code is set as follows: 


Condition codes 


; of Of; Of} Of Normal termination 


i; O; 1tO; O | User-specified number of bytes is a 
a Se negative value or a value greater than 
the task's allocated memory size. 


Example: 
SVC 2,RELEASE 
ALIGN 4 
RELEASE DB 0,3 
Dc H'O! 


DC F'256' 


Figure 3-6 illustrates this example. A task was linked with a 
workspace of 4kb and loaded into memory. After the task is 
loaded, UTOP is located at X'AOO' and CTOP is located at X'18FE'. 
After executing SVC 2 code 2, UTOP is adjusted to X'1900'. After 
executing SVC 2 code 3, 256 bytes of reserved storage are 
released, adjusting UTOP to X'1800'. 
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5632 


UTOP X‘1900' 
(AFTER SVC 2 
CODE 2 EXECUTION) 


aN X'18FE’ CTOP 
X‘100’ BYTES (AFTER EXPANSION 
BY LINK) 
UTOP X‘1800' 
(AFTER SVC 2 


CODE 3 EXECUTION) 


X‘E00’ BYTES 


X'AFE’ CTOP 
(BEFORE EXPANSION 
UTOP X‘A00’ BY LINK) 
(AT LOAD TIME) 
USER CODE 
X‘100° 
UBOT X’‘0’ 


NOTE 


UTOP is the starting address of the first 
contiguous fullword outside the user 
code. 


CTOP is the starting address of the last 


halfword within the allocated task 
address space. 


Figure 3-6 Task Impure Segment for SVC 2 Code 3 


If the user-specified number of bytes is a negative number or is 
more than the number specified by Link, the UTOP address is not 
adjusted and the condition code is set to 4 (V bit set). 
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3.5 SVC 2 CODE 4: SET STATUS 


SVC 2 code 4 modifies the arithmetic fault interrupt bit and the 
condition code settings in the program status word (PSW). Figure 
3-8 shows the PSW and the bits affected by the set status 
operation. When the arithmetic fault interrupt bit setting is 
modified, interrupts are enabled or disabled. When the condition 
code setting is modified, the current 4-bit setting is replaced 
with a new 4-bit setting. This is accomplished through the SVC 
2 code 4 parameter block shown in Figure 3-7. 


Ree ee nnn ee ee ee ce tae eet en taal ned 


10(0) p1(1) 12(2)Arithmetic{3(3) Condition} 
H Option \ Code i fault { code H 
} { parameter | parameter j; 
SVC 2,parblk 
ALIGN 4 
parblk DB option, 4 
DB arithmetic fault parameter, condition 


code parameter 


Figure 3-7 SVC 2 Code 4 Parameter Block Format and Coding 


This parameter block is 4 bytes long, fullword-boundary aligned, 
and does not have to be located ina task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option is a l-byte field that must contain one of the 
following options: 


e Option X'00'-modifies the arithmetic fault 
bit and condition code in the PSW. 


@ Option X'80'-modifies only the condition 
code in the PSW. See Figure 3-8. 
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Code 


Arithmetic 
fault 
parameter 


Condition 
code 
parameter 


Reserved 


is a l1-byte field that must contain 


the 


decimal value 4 to indicate code 4 of SVC 2. 


is a l-byte field that must contain one of 


the following parameters when option X'00' 


is 


specified. For option X'80', this field must 


contain zeros. 


e xX'0O0'-disables all arithmetic 
interrupts for model 7/32 and 


fault 
8/32 


processors. For series 3200 processors, 
only arithmetic fault interrupts due to 


floating point underflow are disabled. 


@e X'10'-enables all arithmetic 
interrupts. 


is a l-byte field that must contain 


fault 


a 


parameter with a hexadecimal value ranging 


from X'00' to X'OF'. 


Arithmetic fault Condition 
Interrupt Bit Reserved Code 


15 16 17 18 19 20 21 22 23 24 27 28 29 30 31 


Reserved 


Figure 3-8 Program Status Word (PSW) 
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An arithmetic fault occurs during an arithmetic operation for any 
of the following conditions: 


@® Fixed point quotient overflow 

e Fixed point division by 0 

@ Floating point overflow and underflow 

@® Floating point division by 0 

The condition code (bits 28 through 31) is set after executing 
certain instructions. Each bit in the condition code corresponds 


to a result or condition caused by executing an instruction. The 
condition code settings for arithmetic operations are: 


Condition codes 


ot a in ee ee ee ee Oe em a A 


civi 


1; Oj Arithmetic carry, borrow, or shifted carry 


ne oe ee ee eS oe 


oO! 1 {0 ; 0 | Arithmetic overflow 


a me Ce ee hme mmo 


i; oj};o; lf 0 4, Greater than 0 


io;}ot:!} o j}1: Less than 0 


ee ee NE ee ee oD ES ee ee 


These four bits have different meanings for logical operations, 
branching operations, and I/O operations. For the definitions of 
the bit settings for each particular operation, see the 
appropriate processor manual. 


3.5.1 SVC 2 Code 4, Option X'‘'00' 


If the SVC 2 code 4 parameter block contains X‘'0O0' in the option 
field, xX'OO' in the arithmetic fault field, and a value ranging 
from X'00' through X'OF' in the condition code field, all 
arithmetic faults are ignored for model 7/32 and 8/32 processors. 
For Series 3200 processors, only arithmetic faults resulting from 
floating point underflow are ignored. For more information on 
Series 3200 arithmetic fault interrupts, see the appropriate 
Series 3200 processor manual. The current condition code value 
in the PSW is replaced with the value specified in the condition 
code field of the parameter block. 
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If the SVC 2 code 4 parameter block contains X‘'O0' in the option 
field, xX'1l0° in the arithmetic fault field, and a value ranging 
from X'OO' through X'OF' in the condition code field, all 
arithmetic fault interrupts are enabled. The current condition 
code value in the PSW is replaced with the value specified in the 
condition code field of the parameter block. 


3.5.2 SVC 2 Code 4, Option Xx'8s0' 


If option X'80' is specified and the condition code parameter 
field contains a value of xX'00' through X'OF', the current 
condition code value of the PSW is replaced with the value 
specified in the condition code field of the parameter block. 
The arithmetic fault field is ignored. 
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3.6 SVC 2 CODE 5: FETCH POINTER 


SVC 2 code 5 loads the starting address of a task's' user 
dedicated location (UDL) into a user-specified register. It then 
stores the current addresses of UBOT, UTOP, and CTOP, located in 
the task control block (TCB) into their corresponding locations 
in the task UDL. This is accomplished through the SVC 2 code 5 
parameter block shown in Figure 3-9. 


a ee ee me eh oh eS MS SRE SN SY MG aA AN Sm ee cern Sem NN UI GR eS SO EM GED URNS oA et mete wees oli mene cmt inet mums aiid tin sats Gm) wiki witim smiiy tum iii erence inh Oldie aon aun fue mam 


10(0) i1(1) i2(2) 13(3) 
Option Code H Reserved | User register} 
i i - a i 
svc 2,parblk 
ALIGN 4 
parblk DB 0,5,0 
DB user register 


Figure 3-9 SVC 2 Code 5 Parameter Block Format and Coding 


This parameter block is 4 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
description of each field in the parameter block follows. 


Fields: 
Option is a l-byte field that must contain the value 
0 to indicate no options for this call. 
Code is a l1-byte field that must contain’ the 
decimal number 5 to indicate code 5 of SVC 2. 
Reserved is a reserved l-byte field that must contain 


a O. 
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User is a l-byte field that must contain a 


register decimal number from 0 through 15 indicating 
the register that receives the UDL starting 
address. 


When executing this call, the UDL starting address, which is 
loaded into the user-specified register, varies for u-tasks and 
executive tasks (e-task). The starting address for a u-task is 
the relative address, which is always 0. The starting address 
for an e-task is the absolute address, which depends on the task 
memory location. 


If the user modified the UDL by changing address pointers or if 
UTOP was changed by a GET or RELEASE STORAGE, the contents of 
CTOP, UTOP, and UBOT in the UDL might not be valid. SVC 2 code 
5 restores this data to a valid state by storing the current 
values of CTOP, UTOP, and UBOT into the UDL. 


Example: 


UDL after execution of SVC 2 code 2 and before execution of SVC 2 
code 5 


5633 


CTOP 
X‘IFE’ 
USER CODE 
UTOP 
X‘14D’ 
X‘100' 
e 
e 
° 


upot xo | XIFE EE X'128" 


CTOP —-UTOP UBOT A tsko &  wmscR- svi14 
RESERVED RESERVED 
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- UBOT X‘0’ 


UDL after execution of SVC 2 code 5 


5634 


CTOP 


USER CODE 


UTOP 
x14 |__| 


X‘100' 


cua IE ES me eal | 


CTOP UTOP UBOT TSKQ A MSGR SV14 
ae RESERVED 


For more information on the UDL, see the OS/32 Application Level 
Programmer Reference Manual. 
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3.7 SVC 2 CODE 6: CONVERT BINARY NUMBER TO ASCII HEXADECIMAL OR 
ASCII DECIMAL 


SVC 2 code 6 converts an unsigned 32-bit binary number located in 
the user register O to an ASCII hexadecimal number or an =ASCII 
decimal number. This is accomplished through the SVC 2 code 6 
parameter block shown in Figure 3-10. 


ee ee Re SO GD eS SD TED SED AD me A Ge ce ee wm SD SD mY ce OD GOD me ely ee mes ey me ey ee me) rm meee ee we ee ee ee ee ee 


10(0) i1(1) 12(2) 
H Optiont+n i Code H Reserved 
[See ae ee eee See eee ee ae re ee eee a 
14(4) 
Address of receiving buffer 
' ! 
| I 

Svc 2,parblk 

ALIGN 4 

parblk DB optiontn,6 
DC H'O' 


DCF A(receiving buffer) 


Figure 3-10 SVC 2 Code 6 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and must be located in a task writable segment. A general 
description of each field in the parameter block follows. 
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Fields: 


Optiontn is a l-byte field that must contain the sum of 
one of the following options and n (n 
specifies a decimal number from 0 through 63 
indicating the number of bytes in the buffer 
specified in the SVC 2 code 6 parameter 
block). 


@ Option X'00'tn converts a binary number’ to 
ASCII hexadecimal. 


@ Option X'40'+tn converts a binary number to 
ASCII hexadecimal, suppressing leading 
zeros. 


@ Option X'80'+tn converts a binary number to 
ASCII decimal. 


e@ Option X'CO'tn converts a binary number to 
ASCII decimal, supressing leading zeros. 


Code is a 1l-byte field that must contain the 
decimal number 6 to indicate code 6 of SVC 2. 

Reserved is a reserved 2-byte field that must contain 
zeros. 

Address of is a 4-byte field that must contain the 

receiving address of the previously allocated buffer 

buffer that receives the converted number. This 
address any byte can be located on any byte 
boundary. 


The receiving buffer should be defined to receive the largest 
number, which is 4,294,967,295 (2 -1), that can be converted 
from register 0. Allocate an 8-byte buffer for binary to ASCII 
hexadecimal. Allocate a 10-byte buffer for binary to ASCII 
decimal. If the user's largest number to be converted is less 
than 2 -l, the receiving buffer can be less than the suggested 
length of the buffer. 


When the user-specified binary number located in register O is 
converted, the result is stored right-justified in the receiving 
buffer with the leftmost significant digits filled with ASCII 
zeros. However, if the converted number is longer than the 
buffer, the leftmost digits of the converted number are lost. If 
suppression of leading zeros is requested, the leftmost zeros’. in 
the receiving buffer are filled with spaces (hexadecimal 20). 
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3.7.1 SVC 2 Code 6, Option X'00'+tn 


If option X'O00'+tn is specified, the unsigned 32-bit binary number 
located in the user register O is converted to an ASCII 
hexadecimal number. The resulting number is stored 
right-justified in the receiving buffer with the leftmost 
significant digits filled. with ASCII zeros (hexadecimal 30). 


Example: 

LI 0,F'8520' 
Svc 2,CONVERT 
ALIGN 4 

CONVERT DB X'00'+8,6 
DC H'O' 
DCF A(BUF) 

BUF DS 8 


Register O before and after execution of SVC 2 code 6 


10 Of O OF2 1/4 Bf Hex 
Receiving buffer after execution of SVC 2 code 6 


Zero filled 


eee eae 


3.7.2 SVC 2 Code 6, Option X'40'+tn 


If option X'40'+tn is specified, the unsigned 32-bit binary number 
located in the user register 0O is converted to an ASCII 
hexadecimal number. The resulting number is stored 
right-justified in the receiving buffer with the leftmost 
significant digits filled with ASCII spaces (hexadecimal 20). 
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3.7.3 SVC 2 Code 6, Option X'80'+n 


If option X'80'+tn is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII decimal 
number. The resulting number is stored right-justified in the 
buffer with the leftmost significant digits filled with ASCII 
zeros (hexadecimal 30). 


Example: 

PROG CONVERT 
LI 0,F'16322' 
SVC 2, CONVERT 
ALIGN 4 

CONVERT DB X'80'+10,6 
DC H'O' 
DCF A( BUF ) 

BUF DS 10 


Register O before and after execution of SVC 2 code 6 


10 O; O Of{3 FIC 2} Hex 


Receiving buffer after execution of SVC 2 code 6 


Zero-filled 


13 O; 3 Of3 0/3 OF3 OF3 1)/3 643 343 213 2{ Hex 


3.7.4 SVC 2 Code 6, Option X'CO'+n 


If option X'CO'+n is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII decimal 
number. The resulting number is stored right-justified in the 
receiving buffer with the leftmost significant digits containing 
zeros filled with ASCII spaces (hexadecimal 20). 
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3.8 SVC 2 CODE 7: LOG MESSAGE 

SVC 2 code 7 sends a user-specified message to the system 
console, user terminal, or user-specified log device, depending 
on task environment. This is accomplished through the SVC 2 code 
7 parameter block in Figure 3-11. Log devices for specific task 
environments are: _— 

e System console for background tasks 

e System console for foreground tasks 

e User MTM terminal for MTM terminal tasks 

e User-specified log device for MTM batch task 


If no user-specified log device is allocated for MTM batch tasks, 
the message is lost. 


<a oem Se me ne eS Ge ee es ES See ee re ee SOR SN MRP SE) a Suen eee me et ee Om eee ne me ee ee eee ate ee 


10(0) }1(1) 12(2) | 
Option H Code H Length of message 
| j ! | 
fei PE ee hee ee ed 
14(4) 
Contents of message* or address of message buffer 
! ! 
( t 

svc 2,parblk 

ALIGN 4 

parblk DB option,7 
DC H' length of message' 
DC C'contents of message' or 


A(message buffer) 


* When the contents of message field is used, the size of 
the parameter block can vary. 


Figure 3-11 SVC 2 Code 7 Parameter Block Format and Coding 
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This parameter block is 8 bytes long if the address of message 


buffer field is used. It is variable in length if the contents 
of message field is used. It must be fullword-boundary aligned 
and does not have to be located in a task writable segment. A 


general description of each field in the parameter block follows. 


Fields: 
Option is a l-byte field that must contain one of the 
following options: 

@ Option X'00' indicates message contents, 
formatted. 

e Option X'20' indicates message contents are 
formatted and sent to system console only. 

e Option X'40' indicates message at specified 
buffer address, formatted. 

@ Option X'60' indicates message at specified 
buffer address is formatted and sent to 
system console only. 

@e Option X'80' indicates message contents, 
image mode. 

e@e Option X'AO' indicates message contents are 
sent in image mode to system console only. 

e@ Option X'CO' indicates message at specified 
buffer address, image mode. 

e Option X'EO' indicates message at speicfied 
buffer address is sent in image mode _ to 
system console only. 

Code is a 1l-byte field that must contain the 

decimal number 7 to indicate code 7 of SVC 2. 

Length of is a 2-byte field that must contain a decimal 
message number indicating the number of bytes’ the 
message occupies. The message can be 
truncated by the log device driver. If the 


message is being logged to the system console, 
its maximum length is determined at system 
generation (sysgen) time. 
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Contents is a variable-length field that must’ contain 


of message the message to be sent to the log device. 

Address of is a 4-byte field that must contain the 
message starting address of the buffer that contains 
buffer the message to be sent to the log device. 


This buffer can be on any byte boundary. 


When the message is sent to the appropriate log device, it is 
either formatted or in image mode. When a formatted message is 
sent to a device: 


e all trailing blanks in the buffer or at the end of the message 
are eliminated, 


@ a carriage return line feed is automatically appended to the 
message, and 


e the message terminates when the end of the buffer or message 
is reached or when a carriage return is found in the message. 


When a message is sent to a device in image mode, the message 
terminates when the end of the buffer or message is reached. If 
in image mode, a message with multiple lines can be sent by 
executing a single SVC. 2 code 7 for each line. However, each 
line should include a carriage return and line feed at the _ end. 
The image options should be used with caution because the amount 
of time that must remain for a carriage return to occur differs 
on various console devices. 


3.8.1 SVC 2 Code 7, Option X'00' 
If option X'00' is specified, the message specified in the 


parameter block is formatted and sent to the appropriate log 
device. 


Example: 
svc 2, LOGMSG 
ALIGN 4 
LOGMSG DB X'00',7 
DC H'32' 
DC C'OPERATOR-PLS MOUNT TPO28 ON MAG1' 
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Contents of message buffer before and after execution of SVC 2 
code 7 


ee ee ee we ew ww ee ee ee a a ww ww ww a ww nn a we a www ee ee ee ee ee ee ee wee ee ee eee eee ee 


14F150/}45152{0/45/52{ {52} 2D{50|4C} 531201 4D/ 4F15514E 1541 20/54}50130/ 321381201 4F (481 20140141146) 31) ASCII 


10 |P JE IR {A tT 10 IR {- {RP {L jS | IM {O JU INIT} IT IP {O12 18 | 10 IN | IM IA 16 1 
Log device after execution of SVC 2 code 7 


OPERATOR-PLS MOUNT TPO28 ON MAG1 


3.8.2 SVC 2 Code 7, Option X'20' 

If option X'20' is specified, the message specified in the 
parameter block is formatted as for option X'00'. The message is 
then sent unconditionally to the system console. 


Option X'20' is used exclusively for tasks running under MTM. 


3.8.3 SVC 2 Code 7, Option X'‘'40' 

If option X'40' is specified, the contents of the message buffer 
pointed to by the address specified in the parameter block are 
formatted and sent to the appropriate log device. 

3.8.4 SVC 2 Code 7, Option X'‘'60' 

If option X'60' is specified, the contents of the message buffer 
are formatted as for option X'40'. The message is then sent 


unconditionally to the system console. 


Opt.ion X'60' is used exclusively for tasks running under MTM. 


3.8.5 SVC 2 Code 7, Option X'‘'80' 
If option X'80' is specified, the message specified in the 


parameter block is in image mode and is sent to the appropriate 
log device. 
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Example: 


sVC 2, LOGMSG1 
SVC 2, LOGMSG2 


ALIGN 4 
LOGMSG1 DB X'80',7 
DC H'32' 
DC C'OPERATOR-PLS MOUNT TPO28 ON MAG1' 
ALIGN 4 
LOGMSG2 DB X'80',7 
DC H'19' 
DC C'SET TAPE AT 800 BPI' 


Contents of message buffer before and after execution of SVC 2 
code 7 


DS ee ee ee 


Ha ia AD ed i ad aah ec le i a a ASCII 


[O IP JE {RJA {T JO IR |- IP IL Is | IM {O {U JN {TT | {TT IP {0 {2 18 | {O IN | JM JA JG jl | 


Contents of message buffer before and after execution of second 
SVC 2 code 7 


ee ee ee ee ee ee ee ee nee ee ee ee ee ee ee eee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee 


ios [So et el eel elloU eee Oat eet eOreneOeO (ey ieee O lee ASCII 


iS jE iT | iT IA TP iB | IAT; (8 (0 ;O | {BGP it |} 


ee ee em ne eee RD OEE sees CRUD SU ST em) em eee ee ce rene eee ee ee ee ee ee eee ee ee eee ee ee 


Log device after execution of second SVC 2 code 7 
SET TAPE AT 800 BPI TPO28 ON MAG1L 


(no line feed appended, message overwritten) 
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3.8.6 SVC 2 Code 7, Option X'AO' 

If option X'AO' is specified, the message specified in the 
parameter block is in image mode as for option X'80', but the 
message is sent unconditionally to the system console. 


Option X'AO' is used exclusively for tasks running under MTM. 


3.8.7 SVC 2 Code 7, Option X'‘'CO' 

If option X'CO' is specified, the contents of the message buffer 
pointed to by the address specified in the parameter block are in 
image mode and are sent to the appropriate log device. 

3.8.8 SVC 2 Code 7, Option X‘'EO' 

If option X'EO' is specified, the contents of the message buffer 
are in image mode as for option X'CO', but the message is sent 


unconditionally to the system console. 


Option X'EO' is used exclusively for tasks running under MTM. 
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3.9 SVC 2 CODE 8: 


SVC 2 code 8 sends the current time of day to a 


buff 


er. 


INTERROGATE CLOCK 


block shown in Figure 3-12. 


user-speci 


fied 


This is accomplished through the SVC 2 code 8 parameter 


te ee A A A oe 


parblk 


1(1) 12(2) 
Code i 

Address of receiving buffer 
SVC 2,parblk 
ALIGN 4 
DB option,8 
DC H'O' 
DCF A(receiving buffer) 


Figure 3-12 SVC 2 Code 8 Parameter Block Format and Coding 


This 


and does not have to be located ina task writable 


parameter block is 8 bytes long, 


fullword-boundary aligned, 


segment. 


A 


general description of each field in the parameter block follows. 
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Fields: 


Option This l-byte field must contain one of the 
following options: 


@ Option X'00'-returns the time of day as two 
fullwords of ASCII data in the form, 
hh:mm:ss 


e Option X'80'-returns the time of day as a 
fullword of binary data indicating the 
number of seconds past midnight. 


@ Option xX'40'-returns the time as_ three 
fullwords of ASCII data in the form: 
hh:mm:ss.sss 


@ Option xX'CO'-returns the time as two 
fullwords of binary data. The first 
fullword indicates the number of seconds 


past midnight. The second fullword 
indicates the number of milliseconds past 
midnight. 
Code is a 1-byte field that must contain the 
decimal number 8 to indicate code 8 of SVC 2. 
Reserved is a reserved 2-byte field that must contain 
zeros. 
Address of is a 4-byte field that must contain the 
receiving starting address of the buffer to receive 
buffer the current time of day. 


The current time of day is calculated as seconds from midnight 
(midnight equals 0) and is taken from the line frequency clock 
(LFC) maintained by the system. 


3.9.1 SVC 2 Code 8, Option X‘'O0O' 
If option X'00' is specified, the current time of day is returned 
in ASCII format to a user-specified buffer located in a_ task 


writable segment. This buffer must be at least 8-bytes long. 
The current time of day is returned as follows. 


Format: 


hh:mm:ss 
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Parameters: 


hh are two ASCII characters representing the 
number of hours. 


mm are two ASCII characters representing the 
number of minutes. 


ss are two ASCII characters representing the 
number of seconds. 


Example: 


Contents of buffer after execution of SVC 2 code 8 option X'O0' 
when current time of day is 10:09:03 


i3 li 3 O/3 Ai3 0/3 913 Aj3 Of3 3] Hex 


oe ce ee eee ee ee ee ee ee ee ee ee eR Se ee ee ee ne oe ee ae ce ee as 


3.9.2 SVC 2 Code 8, Option X'‘'80' 


If option X'80' is specified, the current time of day in seconds 
from midnight is sent in binary format to a user-specified buffer 
located in a task writable segment. This buffer must be at least 
4 bytes long and aligned on a fullword boundary. 


Example: 


Contents of buffer after execution of SVC 2 code 8 option X'80' 
when current time of day is 10:13:48 


10 O; O O/8 FiD C{ Hex 


36828 = 10:13:48 
(decimal) 


The contents of this buffer represent 36,828 seconds’ from 
midnight. 
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3.9.3 SVC 2 Code 8, Option X‘'40' 


If option X'40' is specified, the current time of day is returned 
in ASCII format to a user-specified buffer in a task writable 
segment. This buffer must be at least 12-bytes long. The 
current time of day is returned as follows. 


Format: 


hnh:mm:ss:sss 


Parameters: 


hh are two ASCII characters representing the 
number of hours. 


mm are two ASCII characters representing the 
number of minutes. 


ss are two ASCII characters representing the 
number of seconds. 


sss are three ASCII characters representing the 
number of milleseconds. 


Example: 


Contents of buffer after execution of SVC 2 code option X'40', 
when current time of day is 10:41:32.8 


Dee eee ee eee ee ee ee ee ee 


i 31 ; 30 | 3A {| 34 | 31 } 3A ] 33 {| 32 | 3A {| 38 {| 30 | 30 {| Hex 
ots ttetetatateteteteienetetanadetenetenetenaatanenmensieiedeaneimnptaaateeatstaneenetetane terete ! 
Poskeab “Ob: oe dp ob ob os fb St 24. ¢« | 8 f Of} G4 


ee en a OE OS LS SS A A GO GS eS oe Ge ON ED ED SE Ge SG ee ee ee ee ee eee a 
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3.9.4 SVC 2 Code 8, Option X'CO 
If option X'CO' is specified, the current time of day in seconds 
and milliseconds from midnight is sent in binary format to toa 


user-specified buffer located in a task writable segment. This 
buffer must be 8 bytes long and aligned on a fullword boundary. 


Example: 


Contents of buffer after execution of SVC 2 Code 8 option X'CO' 
when current time of day in ASCII is 10:41:32.8 


The contents of this buffer represent 38,492 seconds and _ 800 
milliseconds from midnight. 
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oe Se Se 


3.10 SVC 2 CODE 9: FETCH DATE 
SVC 2 code 9 sends the current date to a user-specified buffer. 


This is accomplished through the SVC 2 code 9 parameter block 
shown in Figure 3-13. 


Ce nn eer ea De eA A a eee cee ten ee Rone eee ee i ee med 


10(0) i1(1) i2(2) I 
Option Code H Reserved 
ease se ee ee ey Se ae et ee ee ee eee 
14(4) 
H Address of receiving buffer 
1 ! 
I ! 

Svc 2,parblk 

ALIGN 4 

parblk DB 0,9 
DC H'O' 


DCF A(receiving buffer) 


Figure 3-13 SVC 2 Code 9 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 
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Fields: 
Option 
Code 
Reserved 


Address 
of receiving 
buffer 


is a l-byte field that must contain a 0 to 
indicate no options for this call. 


is a 1l-byte field that must contain the 
decimal number 9 to indicate code 9 of SVC 2. 


is a reserved 2-byte field that must’ contain 
zeros. 


is a 4-byte field that must contain the 
starting address of the buffer receiving the 
current date. The buffer must be 8 bytes long 
and located in a task writable segment. The 
buffer can be located on any boundary. 


SVC 2 code 9 sends the current date to the receiving buffer in 
either one of the following: 


Format: 


mn/dd/yy or dad/mn/yy 


Parameters: 


dd 


are two ASCII characters representing the 
month. 


are two ASCII characters representing the day. 


are two ASCII characters representing the 
year. 


When the system is installed, one of these formats is chosen as 


the default for 


all operations. To return the current date in 


the alternate format, use the DATE command at sysgen time. 
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Example: 


ALIGN 4 
DATE DB 0,9 
DC H'O' 
DCF A( BUF ) 
ALIGN 4 
PAUSE DB 0,1 


Contents of receiving buffer after execution of SVC 2 code 9 
when the current date in ASCII is 07/06/81 


ee me Se SS NO CA I OR ape Me Ye A 


3 0/3 6;2 Fi3 8{3 lj Hex 


1 w 
° 
Lee) 
“I 
~~ 
ry 


rot 7F7iZf7iojybo;/7it 8 ft lit ASCII 


at ee eee Ro ee A A ee ee SE ee ee eS wee ee 
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Svc 2 | 
- CODE 10 | 


3.11 SVC 2 CODE 10: TIME OF DAY WAIT 
SVC 2 code 10 suspends the SsvVC calling task until a 
user-specified time of day occurs. Then the calling task resumes 


execution. This is accomplished through the SVC 2 code 10 
parameter block shown in Figure 3-14. 


ee ee ee ee er 


10(0) 11(1) 12(2) 
H Option Code i Reserved 
OF acm ce sc ae eee | 
i4(4) 
Time of day 
SVC 2,parblk 
ALIGN 4 
parblk DB 0,10 
DC H'Q' 


DC Y'time of day' 


Figure 3-14 SVC 2 Code 10 Parameter Block Format and Coding 


The SVC 2 code 10 parameter block is 8 bytes’ long, 
fullword-boundary aligned, and does not have to be located in a 
task writable segment. A general description of each field in 
the parameter block follows. 


Fields: 
Option is a l-byte field that must contain a 0 to 
indicate no options for this'call. 
Code is a 1l-byte field that must contain the 
decimal number 10 to denote code 10 of SVC 2. 
Reserved is a reserved 2-byte field that must contain 


zeros. 
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Time of is a 4-byte field that must contain a decimal 

day number from O through 268,435,455 (278 -1) 
representing in seconds a specific time of day 
when the calling task is to start execution. 
The decimal number specified must be 
calculated in seconds from midnight. 


e 0O seconds equals 00:00:00 A.M. 
of the current day 


(midnight) 


e 86,399 seconds equals 23:59:59 P.M. 
current day 


of the 


See Table 3-2 for a range of values in seconds 
and their corresponding time of day. Any 
value greater than 86,399 refers to days in 
the future. If the specified time of day has 
passed, the same time on the following day is 
assumed. 


TABLE 3-2 TIME OF DAY VALUES CALCULATED IN 
SECONDS FROM MIDNIGHT 


i TIME OF DAY TIME OF DAY 
} 00:00:00 HOURS 23:59:59 HOURS 
t 


DAY i (MIDNIGHT) { (P.M. ) { 
H SS SSS See eee Se SS ES ee EE SEE EEE See eee ess 
lst | 
} (current) | a) H 86,399 H 
I t ! ! 
' | { i 
H 2nd H 86,400 [. 172,799 H 
{ 1 i ! 
' ( t t 
H 2nd { 172,800 H 259,199 | 
! ’ { ! 
{ 1 ! ! 
H 4th H 259,200 H 345,599 H 
4 ! t i 
t 1 1 t 
| 4th H 345,600 1 431,999 H 
H 
H 6th H 432,000 H 518,399 H 
1 ! | { 
1 ' J { 
{ 7th H 518,400 H 604,799 H 
. 
. 
: | : | ; 
i 3,107th jj 268,358,400 } 268,435,455* | 
i (maximum) jj; { (max imum) H 


* 268,435,455 seconds equals 
of the final day 


21:24:15 hours 
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After executing SVC 2 code 10, the condition code is set to 
indicate if the call was successful. The possible condition code 
settings are: 


Condition codes 


(Ci ViGitL | 

H Srrresrerw£s=se=s | 

; Oo}; 0; 0} 0 | Normal termination 

Le ee en at oe ce 

; Oo; 1} Of}; O {| Sufficient system space is unavailable; 


saleetonianieententatesetietmetentantaen no wait occurred. 


If this call is executed and insufficient system space exists, no 
wait occurs and the condition code is set to 4 (V bit set). 


Example: 

SVC 2,WAITDAY 
Svc 2, PAUSE 
ALIGN 4 

WAITDAY DB 0,10 
DC H'Q!' 
DC F'12165' Equal to 03:22:45 A.M. 
ALIGN 4 

PAUSE DB 0,1 
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3.12 SVC 2 CODE 11: INTERVAL WAIT 


SVC 


2 code 


11 


user-specified 
elapses, the calling task begins execution. This is accomplished 
through the SVC 2 code 11 parameter block shown in Figure 3-15. 


suspends the SVC calling task until a 
interval occurs. When the specific interval 


te nee em ne ARE net ers ee ne a DU SR ce ee eS EE OT ee EP SE GE EE EE Se ee Ee ee ee ee ee ms ome ee 


parblk 


1(1) 12(2) 
Code | Reserved H 
i H 
SS cls a le Tecan es “antes sms ni’ nmi “es "mas <email en “athe, se Sunt Gm cen en SC Skah; el “cee “os es wm Sleeves el new nt“ al “ah, i 
1 
Interval H 
i 
SVC 2,parblk 
ALIGN 4 
DB 0,11 
DC H'O' 
DC F'interval' 


Figure 3-15 SVC 2 Code 11 Parameter Block Format and Coding 


This 


parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option 


Code 


is a l-byte field that must contain 0O to 
indicate no options for this call. 


is a l-byte field that must contain the 


Gecimal number 11 to indicate code 11 of SVC 
2. 
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Reserved is a reserved 2-byte field that must’ contain 
zeros. 


Interval is a 4-byte field that must contain a decimal 
number from 0 through 268,435,455 (278 -1) 
representing in milliseconds the interval that 
must elapse before the calling task resumes 
execution. The interval starts when this call 
is executed and ends after the specified 
milliseconds elapse. 


After executing SVC 2 code 11, the condition code is. set to 
indicate if the call was’ successful. The possible condition 
codes are: 


Condition codes 


Normal termination 


i; Of; 1} Ot O | Sufficient system space is unavailable; 
[SS Se = no wait occurred. 


If this call is executed and insufficient system space exists, no 
wait occurs and the condition code is set to 4 (V bit set). 


Example: 

SVC 2,WAITINT 
SVC 2, PAUSE 
ALIGN 4 

WAITINT DB 0,11 
DC H'O! 
DC F'32768' Equal to 32.768 seconds 
ALIGN 4 

PAUSE DB 0,1 
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3.13 SVC 2 CODE 15: CONVERT ASCII HEXADECIMAL OR ASCII DECIMAL 
TO BINARY 


SVC 2 code 15, the inverse of SVC 2 code 6, converts an ASCII 
decimal or hexadecimal number to an unsigned 32-bit binary 
number. Character strings can be input in either upper or 
lowercase. 


The result is stored in the user register 0. This is 


accomplished through the SVC 2 code 15 parameter block shown in 
Figure 3-16. 


RN ee ee De et dD ee ee ld 


10(0) il(1) 12(2) i3(3) 
Option Code | Reserved | User register; 
i { 
SVC 2,parblk 
ALIGN 4 
parblk DB option,15,0 
DB user register 


Figure 3-16 SVC 2 Code 15 Parameter Block Format and Coding 


This parameter block is 4 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option is a l-byte field that must contain one of the 
following options: 


@e Option X'00' converts ASCII hexadecimal to 
binary. 


@ Option X'40' converts ASCII hexadecimal to 
binary, skip leading spaces. 
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e Option X'80' converts ASCII decimal to 
binary. 


e Option xX'CO' converts ASCII decimal to 
binary, skip leading spaces. 


Code is a 1l-byte field that must contain the 
decimal number 15 to denote code 15 of SVC 2. 
Reserved is a reserved l-byte field and must contain 0. 
User is a l-byte field that must contain the user- 
register specified register number. This register 


should contain the address of the buffer that 
contains the ASCII hexadecimal or ASCII 
decimal number to be converted. This buffer 
can be located on any boundary. After 
executing SVC 2 code 15, register O contains 
the result, and the user-specified register 
contains the address of the byte following the 
last number to be converted. 


The valid ASCII hexadecimal numbers are O through 9 and A through 
F. The valid ASCII decimal numbers) are O through 9. Any 
character, other than those ASCII hexadecimal and ASCII decimal 
numbers specified, causes the conversion process to stop, the 
nonconverted byte address to be stored in the user-specified 
register, and the condition code to be set to 0. The possible 
condition code settings that can occur after executing SVC 2 code 
15 are: 


Condition codes 


ic;iviGtitL | 

| een eeesseesecer | 

;O}; Of} O { O {| Normal termination 

[2S SSS Se H 

; Of; Of; Of 1} =No numbers converted; register 0 contains 
Oeste a a ok Se ee i] 

i | zeros. 

; oO} 1 | Of O } Value of the number to be converted is 


--------------- greater than 2,147,483,647 (25! -1). 


3.13.1 SVC 2 Code 15, Option X'00' 


If option X'00' is specified, the ASCII encoded hexadecimal 
number in the buffer, specified by the address in the user 
register is converted to a binary number. The resulting number 
is stored right-justified in register 0O with the leftmost 
significant bits filled with zeros. 
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Example: 


Buffer before and after execution of SVC 2 code 15 


Starting 
address Address 
X'14E' X‘'151"' 


a a Yr A ee Pe a ON 


10 O;0 O;0 GIA FI 


User-specified register before execution of SVC 2 code 15 
i0 O;0 O;0 1;4 BE} Hex 


ee ee eee eo ee 


10 0:0 OO 11/5 1{ Hex 


ee eee ee 


If a number other than a valid ASCII number is’ specified, that 
number is not converted, and the address is stored in the 
user-specified register. 


If an ASCII number is preceded by at least one space, no 
processing takes place, the contents of the user-specified 
register remain the same, register O contains all zeros, and the 
condition code is set to l. 


If the value of the ASCII number is greater than 2,147,483,647 
(231 -1), the number is converted, the resulting number is stored 
right-justified in register 0 with the leftmost significant bits 
truncated, and the condition code is set to 4 (V bit set). 
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Example: 


Buffer before and after execution of SVC 2 code 15 


Starting address Address 
X'152' X'15¢C" 


13 213 1/3 413 7/3 413 8/3 313 6/3 643 5/2 Of ASCII 


622i li4i7;4;8i3;:6;6 4; 5 j | 


{0 O0;0 O70 1;5 2{ Hex 


Overflow -ree ewe eee ene 
21 14 714 813 636 5} ASCII 


User-specified register after execution of SVC 2 code 15 


i0 O;0 O;O 11/5 C} Hex 


ASCII number greater than 2-7 


3.13.2 SVC 2 Code 15, Option X'40' 


If option xX'40' is specified, the ASCII encoded hexadecimal 
number in the buffer, specified by the address in the user 
register, is converted to a binary number with leading’ spaces 
ignored during the conversion. The resulting number is stored 
right-justified in register 0 with the leftmost significant bits 
filled with zeros. 
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Example: 


Buffer before and after execution of SVC 2 code 15 


Starting 
address Address 
x’ 152" X'156' 


one a 


:0 0;0 O10 6{A Fi Hex 


ee ee 


10 0:0 O;O 115 2) Hex 


me Le NN a 


ee ene ee ieee ee eee 


10 0:0 O10 1;5 6; Hex 


ee a ON ce yee net ae ioe ce 


Normal termination 


ee se ee 


3.13.3 SVC 2 Code 15, Option xX'80' 


If option X'80' is specified, the ASCII encoded decimal number in 
the buffer, specified by the address in the user register, is 
converted to a binary number. The resulting binary number is 
stored right-justified in register 0 with the leftmost 
significant bits filled with zeros. 


If a character other than a valid ASCII decimal number is 


specified, that character is not converted and the invalid 
character address is stored in the user-specified register. 
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Example: 


Buffer before and after execution of SVC 2 code 15 


Starting Address of byte 


address not converted Address 
ae X'154' X'156' 


13 513 91/4 113 342 O} ASCII 


10 0;0 0/0 O;3 Bi Hex 


10 O00 OjO0 115 2) Hex 


User-specified register after execution of SVC 2 code 15 


10 Oj{0 Oj0 1/5 4} Hex 
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Condition codes 


oe aes ee SU UY ee ee ee OO ee Sy 


H 

: 

i; Normal termination 
j 

1 


Oe 


' Of; 1 40% 04 ASCII number greater than 2" -1 


ee ee er eer 


If a decimal number represented in ASCII code is preceded by at 
least one space, no processing takes place, the contents of the 
user-specified register remain the same, register 0 contains all 
zeros, and the condition code is set to l. 


If the value of the ASCII decimal number is greater than 
2,147,483,647 (2°' -1), the number is converted, the resulting 
binary number is stored right-justified in register 0 with the 
leftmost significant bits truncated, and the condition code is 
set to 4 (V bit set). ‘ 


3.13.4 SVC 2 Code 15, Option X'CO0' 


If option X'CO' is specified, the ASCII encoded decimal number in 
the buffer, specified by the address in the user register, is 
converted to a binary number, with leading spaces ignored during 
the conversion. The resulting number is stored right-justified 
in register 0O with the leftmost significant bits filled with 
Zeros. 
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SVC 2 | 
CODE 16 } 


3.14 SVC 2 CODE 16: PACK FILE DESCRIPTOR 


SVC 2 code 16 formats a user-specified unpacked file descriptor 
(fd) to the packed format used within the SVC 7 parameter block 
(see bytes 8 through 23 of the SVC 7 parameter block). Figure 
3-17 illustrates the SVC 2 code 16 parameter block format. 


Doel ree lle Re Re ne ee eR ee Ee ee ee 


10(0) i1(1) 12(2) 
{ Option H Code H User register H 
(poceiare cat ecu act < eins ee ae Ae ates ieee Peas ae 
14(4) 
| Address of packed fd area 
' ! 
t t 

SVC 2,parblk 

ALIGN 4 

parblk DB option, 16 
DC H'user register number' 


DCF A(packed fd area) 


Figure 3-17 SVC 2 Code 16 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located ina task writable segment. A 
general description of each field in the parameter block follows. 
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Fields: 


Option 


OPTION 
X'00! 


X'40' 


X'10' 


X'50' 


X'20' 


X'60! 


X'80! 


X'CO' 


is a l-byte field that must contain one of the 
following options: 


MEAN ING 
Default volume is the user volume. 


Default volume is the user volume. Skip 
leading spaces. 


Default volume is the system volume. 


Default volume is the system volume. Skip 
leading spaces. 


Default volume is the spool volume. 


Default volume is the spool volume. Skip 
leading spaces. 


No default volume. 


No default volume. Skip leading spaces. 


In a non-MTM environment, the default user 
volume is the same as the default system 
volume. Options X'0O0O' or X'40' are preferred, 
since they are compatible with normal usage in 
an MTM environment. 


NOTE 


The above options are intended for 
use by non-privileged u-tasks 
only. These options pack file 
descriptors that use the /P, /G, 
or /S file classification. If a 
privileged u-task or e-task uses 
these options to pack an fd with 
a /P, /G, or /S file 
classification, the resulting 
packed fd will have an account 
number in its file class field. 
See Section 3.14.9 for the SVC 2 
code 16 options for e-tasks or 
privileged u-tasks. 
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Code 


User register 


Address of 
packed fd 
area 


is a 1-byte field that must’ contain 
decimal number 16 to indicate code 16 of 
2. 


is a 2-byte field that must contain 
user-specified register number containing 
unpacked fd address. 


is a 4-byte field that must’ contain 


the 
SVC 


the 
the 


the 


address of the area that receives the packed 


file descriptor. 


The condition codes set after packing an fd are: 


Condition codes 


;010104 
Lode-p ay 
O04. 
ar it 0 1 


If more than one condition results from a pack fd 


Normal termination 


| No volume name present in unpacked fd 


i An account number or file class present 


--} in unpacked fd 


| Syntax error present in unpacked fa 


| No extension present in unpacked fd 


combination of condition codes are set. 


When 


NOTE 


a period followed by no valid 


characters is specified in the unpacked 


fd, 


it is treated as an explicit request 


for an extension containing spaces. The 
condition code is set to 8 (C bit set). 
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operation, 


All lowercase characters in the user-specified fd are converted 
to their equivalent uppercase characters after the pack fd 
operation occurs. The entire user-specified fd (unpacked format) 
can be from 1 to 19 characters. Allowable characters are: 

e A through Z (uppercase) 

e a through z (lowercase) 


e O through 9 (numerics) 


e selected special characters (symbols) 
The format of the user-specified fd is: 


Format: 


sae f [Filename] [- [ext] | /\c} 


dev 
actno 
Parameters: 
voln or dev: is a disk volume or device name from one _ to 


four characters. 


filename is a filename from one to eight alphanumeric 
characters. 
-ext is the extension name of from one to three 


characters, preceded by a period. 


P are single alphabetic characters representing 
G the file class. They are: P for private file; 
Ss G for group file; and S for system file. 

actno is an account number ranging from OO through 


65,535. 


The area receiving the packed fd must be 16 bytes’ long, 
fullword-boundary aligned, and located in a task writable 
segment. See Figure 3-18. Since this area is identical to bytes 
8 through 23 of the SVC 7 parameter block, these bytes can _ be 
designated as the receiving area. 
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teen Diam re A A A A Oe ee i eed 


ee a a ei etna tnd 


Filename 


1 15(F) 


ee 


File class/ 


}Account number} 


ee ee ee ce SD ND SE eR eee ie NaS mt oe ey mY GS Me me A ee Se A i Re De ne OD ee my SS) eS ce Se oe re ee ee ee ee eee es ee, 


Figure 3-18 Packed File Descriptor Area 


Fields: 


Volume name 
or 
device name 


Filename 


Extension 
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is a 4-byte field that receives the packed 
format of the volume name or device name. If 
the volume or device name is less than 4 
bytes, it is left-justified with spaces 
(X'20'). If mo volume or device name _ is 
specified, the user-specified option 
determines the result. 

is an 8-byte field that receives the packed 
format of the user-specified filename. If the 
filename is less than 8 bytes, it is 
left-justified with spaces (X'‘'20'). If no 


filename is 
with spaces. 


specified, 


this field is filled 


is a 3-byte field that receives the packed 
format of the user-specified extension. If 
the extension is less than 3 bytes, it is 
left-justified with spaces (X'20'). If no 
extension is specified, this field is filled 


with spaces. 


File class/ is a 1l-byte field that receives the packed 


account format of the user-specified file class. Any 
number value other than P, G, or S inthe file 
class field of the unpacked fd causes a syntax 
error. If no file class is specified in the 


unpacked fd, an S is returned in the class 
field of the packed fd when running under’ the 
operating system. P is returned in the class 
field of the packed fd when running under MTM. 


NOTE 


If the SVC 2 code 16 options’ for 
privileged tasks are used, an account 
number is returned to this field. (See 
Section 3.14.9.) 


After the pack fd operation occurs, the user-specified register 
contains the address of the byte following the unpacked fd. If 
a syntax error is detected, the user-specified register contains 
the address of the first byte of the unpacked fd. The following 
examples show the results of issuing an SVC 2 code 16 for a _ task 
running under MTM. The default system volume is M300. 


When a device name is encountered in the user-specified fd, the 


pack fd operation returns spaces to the filename, extension, and 
file class/account number fields of the packed fd. 


Example 1: 


Unpacked fd 
address Address 
Xx'118' X'126' 


1A Di3 3/3 Of3 O13 Aj5 315 644 343 2/2 E{3 113 642 FI{5 Of2 O| ASCII 


00100101; 18} Hex 


Packed fd 
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User-specified register after packing fd 


ete Re 


100;00;01;26; Hex 


Ce ee 


H 
Cf} Vi GQytytL y H 
jenceasre meee see | H 
' Oo} Of; Of; O {| Normal termination i 
es hens eee eae H 
Example 2: 
Unpacked fd 
address Address 
X'118' X'11D'° 


Ce 6 ee ee oe 


i eee 


— eee ee ee ee 


i00;00;01;18{ Hex 


Ce i eee a ead 


i4 Di3 313 O13 Of2 Of2 Of2 OF 2 Of2 OF 2 OF2 OF 2 OF 2 OJ2 Of2 Oj2 DO; ASCII 


I ce Be ce Ree an 


|00 0001; 18} Hex 


No extension present in unpacked fd; 
a syntax error present in unpacked fd 
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The unpacked fd contains a character that was interpreted as a 
field separator. 


Example 3: 


Unpacked fd 
address Address 
x'118! X'11F' 


4 cee She 0/3 0:3 Ai5 3/5 6/2 6/3 2i2 E{/3 1/3 6;2 Fi5 Of ASCII 


NE ee ee ee es ee ee ee eee es 


mh ae tne eae el et a ee 


100;00;01;18{ Hex 


ne eee a ee ae ee ee 


ee ee ee ee ee ee ee ee ee ee ee ee ee ee we ee eee ee ee we ee oe ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 


i4 Di3 313 013 O'5 335 612 Oj2 Of2 O}2 Of2 OFZ Of2 Of 2 Oj2 OF{5 01 ASCII 


eee ce ee ee eee ee ee ee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee a ee ee ee ee eee ee ee 


USS ee per Tete register after packing fd 


100;00{01;18{ Hex 


ee ee 


Pc iviGiLt 
| Sem esecs ee cees | 
i Lt lit 0; 0 { No extension present in unpacked fd; 


ee Et eet teenie syntax error present in unpacked fd 


The above example shows an illegal character within the filename. 
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Example 4: 


Unpacked fd 


oe eee oe ee ee eee ee ee ee ee 


(4 315 214 4;5 2}2 E} ASCII 


14 0/3 3/3 O73 OF4 345 2/4 415 2$2 Of2 O}2 Of2 O}2 O}2 Oi2 O15 Oj} ASCII 


cee eee ane ee em eee tee ec ee ee ee ee me ee ce ee eee ee eee ee eee ee ee ee ee we ee ce ee ee ee eee ee ee 


No volume name present in unpacked format 


The example above shows a default volume option with an explicit 
request for an extension containing spaces. 


Example 5: 


Unpacked fd 


15 OF4 314 2/3 3/3 242 Fi5 3{ ASCII 


14 DI3 3}/3 0/3 OF5 O14 344 2/3 3413 242 Of2 OF 2 Of2 OF 2 O}2 OF5 3; ASCII 


No extention present in unpacked fd; 
Sess ees SSeS no volume name present in unpacked fd 
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If a syntax error occurs, the scan of the unpacked fd terminates 
at the byte that caused the syntax error and the area receiving 
the packed fd is filled with indeterminate code. Check the 
condition code to determine if a syntax error occurred. 


3.14.1 SVC 2 Code 16, Option X'0O0' 


If option X'00' with no volume name is specified, the default is 
the system volume. The first byte of the unpacked fd (currently 
pointed to by the user-specified register) is the starting 
location of the pack fd operation. 


The following examples use M67A as the default system volume. 
Example 1: 


Unpacred fd 


a 314 8/3 215 O75 214 Di2 E}3 633 1/3 3/2 Fi4 7{ ASCII 
Ge NL a aa ae a As 


iC; Hi2; Pj REMi~ tT oOELIEZSstESIG YI 


Cl ee ne eee ee ee ee ee 


14 Di3 613 714 114 314 8/3 2/5 OF5 244 DiJ2 O}2 OF3 64/3 1/3 344 7i ASCII 


—— a ee cee ee mY Oe em em oe ee ee OS ee ee ee ce ee we ee ee ee ee ee ee ee eee oe ee ee eee ee ee ee ee ee ee ee ee oe 


No volume name present in unpacked fd 


ee ee ee ad 


Example 2: 


Unpacked fd 


i2 Of4 Di3 3/3 Of3 114 344 813 215 O15 214 Df2 E}3 64/3 1i3 34/2 Fl4 - ASCII 


i PMi3iOj;jliclHi 2tiPtiERIMi.~ F6TLI3tSIG 
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Packed fd 


14 Di3 613 714 1{2 Of2 OF2 Of2 O}2 O{2 OF2 OF 2 Of2 Oj2 Oj2 Oj2 S ASCII 


No extension present in unpacked fd; 
SoS SSS sre syntax error present in unpacked fd; 
no volume name present in unpacked fd 


As shown in the above example, if the first character in the 
unpacked fd is not valid, processing stops. The system volume 
name is the default, and the filename, extension, and class 
fields are modified to blanks. 

3.14.2 SVC 2 Code 16, Option X'40' 

If option X'40' with no volume name is specified, the default 
user volume and all preceding spaces are ignored. All spaces are 
ignored from the first byte of the unpacked fd (currently pointed 
to by the user-specified register) to the first character in the 
unpacked fd. 


The following example uses M67A as the default system volume. 


Example: 


Unpacked fd 


i tee nartelinn nent temaieetiene 


i2 014 31:4 8/3 215 O75 214 Dij2 E}3 6/3 113 332 Fi4 7} ASCII 


a ei at eee 


oe eee ee eS em ee ce Gee eee ee me eee ee ee mY ee ee ee ee ee ee ee ee ee ee ee eee cee Oe ee ee ee ee ee ee ee oe es ee ee ee ee ee ee ee 


ee ae a ee Oe ee oe oe ce OD ce cee ED ee ee ee ee cee ee ee GS Ee eee OD ee ee eS ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee 
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Condition code 


No volume name present in unpacked fd 


ae et A Lee ON ae me ig ee ee ee eo 


3.14.3 SVC 2 Code 16, Option xX'10' 


If option X'10' with no volume name is specified, the default is 
the system volume. The first byte of the unpacked fd (currently 
pointed to by the user-specified register) is the starting 
location of the pack fd operation. 


The following examples use M300 as the default volume. 


Example 1: 


Unpacked fd 


ta ee a LL Nc A eG ne ee SS 


(5 345 6/4 313 2/2 Ei{3 1/3 642 F{5 Of} ASCII 


et samt ek ma i a EL Rc ee SY AO me OD ene GS GS Sn 


ae A A AS Ce EY OY ES mY A GS Se GE RS SE GR ED ee EE eS ee ee ee ee ee Oe ee ee ee el 


No volume name present in unpacked fd 


Example 2: 


Unpacked fd 


12 O14 Di3 643 744 143 AUS 315 644 343 242 E{3 143 ena Fi{5 Oj ASCII 
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Packed fd 


{4 Di3 3413 O13 O}2 Of2 O{2 Of2 Ol] O12 Of2 Of2 O2 Of2 Of 2 Of2 Of} ASCTI 
{Mi3 | 0}; Of | i t 


No extension present in unpacked _ fd; 
Si a syntax error present in the unpacked fd; 
| no volume name present in the unpacked fd 


As shown in this example, if the first character in the unpacked 
fd is not valid, processing stops. The system volume name is the 
default and the filename, extension, and class fields are 
modified to blanks. 

3.14.4 SVC 2 Code 16, Option X'50' 

If option X'50' with no volume name is’ specified, the default 
system volume and all preceding spaces are ignored. All spaces 
are ignored from the first byte of the unpacked fd (currently 
pointed to by the user-specified register) to the first character 
in the unpacked fd. 


The following example uses M300 as the default system volume. 
Example: 


Unpacked fd 


ee ee ce me ee ee ee ee re rm ee eee ee ee ee ren ie we me ee ee ee ee wee ee ee 


12 Of2 OF2 OF5 445 3{2 E4 315 315 3{2 Fi4 7j{ ASCII 


Cnt ee he ier Eee ee Ren ee ee en ee eiendiendie teed ie 
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Condition code 


ee ee ee) 


ee ee et ee ee 


3.14.5 SVC 2 Code 16, Option X‘'20' 
If option X'20' with no volume name 
the spool volume. The first byte 


pointed to by the user-specified 
location of the pack fd operation. 


Example 1: 


unpacked fa 


: ah ae sated ning eld a cae TOR SAO hee TS OS Me Ae es UN al Dm og ee 


No volume name present in unpacked fd 


is specified, the default is 
of the unpacked fd (currently 
register) is the _ starting 


15 315 614 31/5 415 315 412 Ei4 3;4 114 C} ASCII 


enn ene en eee ae ie ee ee amietinenal 


— a om oe ww ow oe oe ow om ow ww oe oe mF ee we oe we oe a oe 


15 31/3 343 O13 O15 315 614 315 4{5 315 4{2 Of2 Of4 344 144 CIS Ot ASCII 


a ee eee SD eee mS eS ee a me eS ee ee ee ge ee ee ee ee ee ey ee 


ee eee i ea 


Example 2: 


Whescises fd 


A A Oe Nee Ye ne ne Oe 


oer ome ee ce em ee ee ee ee ee ee ee ee ee ee ee 


No volume name present in unpacked fd 


12 O12 OF5 315 644 345 4/5 315 412 E{4 344 es C{ ASCII 


Ce eee ee ee ee el 
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Packed fd 


a a YS ee ES ce DN eG SO GDS SEE SS me OE nee ee ee eo ee ee me cee oe ee cee ee ee ee ee ee ee oe ee ee ee ee ee ee ee ee ee eee ee ee 


rc;~viGi Lt 

| =eneeerece=se=ee=| No extension present in unpacked fd; 
; Lt li{toytl it syntax error in unpacked fd; 

i a ad ae aie no volume name in unpacked fd 


As shown in this example, if no volume name is specified and the 
filename is preceded by at least one space, the spool volume is 
the default and the filename, extension, and class fields are 
modified to blanks. 


3.14.6 SVC 2 Code 16, Option X'60' 

If option X'60' with no volume name is specified, the default is 
the spool volume and ail preceding spaces are ignored. All 
spaces are ignored from the first byte of the unpacked fd 
(currently pointed to by the user-specified register) to the 


first character in the unpacked fd. The default volume for _ the 
following examples is S300. 


Example 1: 


Unpacked fd 


Ce ee a ee en ctentandntinatiantiiontiationd 


14 914 Ci5 415 3/5 4/2 E{5 415 3/4 Bi2 Fi5 3} ASCII 


ee ee ie 


Ee ee ee se ee ee es eee ee ee 
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Condition code 


No volume name present in unpacked fd 


Example 2: 


Unpacked fd 


are ee i Me Me i Reet Bee eatin tadeemelend 


'2 OF4 914 Ci5 445 345 442 B{5 445 31/4 Bi2 Fi5 3; ASCII 


i4 Di3 313 O73 O14 914 Ci5 415 315 4/2 Of2 Of2 OF5 4/5 344 Bi5 3] ASCII 


emt a mee ee tee ne 


Q 
< 


No volume name present in unpacked fd 


ee a me mn en ke ee we ee em ee ee 


If no volume name is specified and the filename is preceded by at 
least one space, all preceding spaces are ignored and the default 
is the spool volume. The spool volume name and remaining fd are 
packed. 


3.14.7 SVC 2 Code 16, Option X'80' 


If option X'80' with no volume name is specified, the contents of 
the volume name field before executing the pack fd operation is 
used as the volume name. The first byte of the unpacked fd 
(currently pointed to by the user-specified register) is the 
starting location of the pack fd operation. 
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Example l: 


Unpacked fd 


(4 Fi5 OF5 44/3 813 Of2 E14 334 114 Ci ASCII 


13 O13 Of3 O13 OF4 FISH OFS 413 8I3 Of2 Oj2 O}2 O44 344 144 CHS a ASCII 


No volume name present in unpacked fd 


If a volume name is specified and is preceded by at least one 
space, that volume name is ignored and the contents remaining in 
the volume name field before executing the pack fd operation are 
used as the volume name. The filename, extension, and class 
fields are modified to blanks as shown in Example 2. 


Example 2: 


Unpacked fd 


12 O}2 Of4 Di3 1/3 OF4 113 Aj4 FIS 015 413 8/3 0/2 E{4 3/4 114 Cj} ASCII 
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Packed fd location contents before pack fd operation 


i5 313 313 O73 OF5 714 844 115 414 5{5 6)4 515 214 544 Ci5 334 5]{ ASCII 


15 343 313 O13 Of2 Of2 Of2 Of2 O{2 Of 2 Of 2 Of2 Of2 Of2 OF2 Of2 Of} ASCII 


ee ene me ree ee ae eee et cae cee wm cee OSS ee meee ee cee DOO ee Se ee Ge ee ee ee ee ee ee eee ce Se eee eee me ee ee ee 


a A a ne ee ee te ee ce a 


(Cc; ViGt Ly 

| ##=s=seeeeerne=/ No extension present in unpacked fd; 

; 1 i ltoft dl |} syntax error present in unpacked fd; 
Bi el ae ag eae a lee oe no volume name present in unpacked fd 


If no volume name is specified and the filename is preceded by at 
least one space, the contents remaining in the volume name field 
before executing the pack fd operation are used as the volume 
name. The filename, extension, and class fields are modified to 
blanks as shown in Example 3. 


Example 3: 


Unpacked fd 


Cee eee enn ene ee ee eee ee ee 


i2 O74 eV O15 413 813 Of2 E}4 314 114 Cj ASCII 


I a a dd ee ee ee ee 


ee ee De dd dd De 


14 O13 2/3 5/2 Of5 714 814 115 4/4 515 644 535 214 544 CiS 344 5] ASCII 


14 DI3 243 542 O12 Of2 O}2 Of 2 Of2 OJ2 Of2 OF 2 Of2 Of2 OF2 O}2 Of} ASCII 
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Condition code 


CN eee 


(Ci vi Gi | 

[===ssseeereeeez| No extension present in unpacked fd; 

i lL} 1]; O0 4; 1 {| Syntax error present in unpacked fd; 
SOE ae mt -“------- no volume name present in unpacked fd 


3.14.8 SVC 2 Code 16, Option X'CcOo' 

If option X'CO' with no volume name is specified, the contents of 
the volume name field before executing the pack fd operation are 
used as the volume name and all preceding spaces are ignored. 
All spaces are ignored from the first byte of the unpacked fd 


(currently pointed to by the user-specified register) to the 
first character in the unpacked fd. 


Example 1: 


Unpacked fd 


Se a mem A SS ee GN mS mE are ME SONOS me ee wee ee tne we 


15 OF5 2/4 Dj2 EV 613 Li3 342 et? O; ASCII 
| 


a SCT SE NY eee ent ome OR meee mS a ee a ee ee me ee me we ee ee 


14 445 3/4 313 315 714 8)4 115 414 515 64/4 535 234 544 Ci5 344 5; ASCII 


14 445 314 313 3/5 O15 2/4 Dj2 Of2 Of2 Of2 O]2 OF3 64/3 1/3 315 Of ASCII 


rC;VviGiLy 
| Pees essere ssce | 
iO}; O | O | 1 {| No volume name present in unpacked fd 
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If a volume name is specified and is preceded by at least one 
space, all preceding spaces are ignored and that volume name and 
remaining fd are packed as shown in Example 2: 


Example 2: 


Unpacked fd 


aati cerceliema tice tienen ti cancelitacenticmetcnati mee Reel A Re ee De ee ee ee ee 


re a YS GI RS Se RS GD GE Se SG GOED UD ee ey GD GP GD Gee SU EE EG ae GS Ee ee ee SD OU ce We Ge oe oReP eee dee 


14 Di3 613 71/4 115 O15 214 Dj2 O}2 O}2 O}2 Of2 OF3 643 143 315 Of} ASCII 
i} 


yj 
bi hos 


Normal termination 


3.14.9 SVC 2 Code 16 Options for Privileged Tasks 


Only privileged u-tasks, e-tasks, and privileged d-tasks are 
allowed to pack an fd so that the resulting packed fd has an 
account number in its file class/account number field. A u-task 
becomes privileged if the account privileges task option 
(ACPRIVILEGE) is specified when the task is Link-edited. 
ACPRIVILEGE allows u-tasks to access files by account number 
rather than file class. The range of account numbers) available 
to the task is 0-65,535, excluding 255. To access files on 
account 255, the bare disk I/O task option (DISC) must also be 
specified when the task is link-edited. 


E-tasks always have account privileges. 


CAUTION 


IF THE OS/32 TASK LOADER HAS THE E-TASK 
LOAD OPTION DISABLED, ALL U-TASKS WILL BE 
DENIED ACCOUNT PRIVILEGES REGARDLESS OF 
THE TASK OPTIONS SPECIFIED BY LINK. 
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The following SVC 2 code 16 options are used by an _ e-task, 
privileged d-task, or privileged u-task to produce a packed fd 
that has an account number in its file class/account number 
field: 


OPTION MEAN ING 
x'O8' Default volume is the user volume 
X'48! Default volume is the user volume; skip 


leading spaces 


X'18' Default volume is system volume 

Xx'58' Default volume is system volume; skip leading 
spaces 

X'28' Default volume is spool volume 

X'68' Default volume is spool volume; skip leading 
spaces 

X'88' No default volume 

x'cs'! No default volume; skip leading spaces 


When a privileged task uses one of the above options to pack an 
fd that has’ either an account number or file class in its file 
class/account number field, SVC 2 code 16 returns an account 
number to the resulting packed fd and sets the G bit in the 
condition code. 


If neither an account number nor a file class is specified in the 
unpacked fd, the file is packed with account number O (if the 
task is running at the system console) or the user's private 
account number (if the task is running under MTM). 
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{ Svc 2 


3.15 SVC 2 CODE 17: SCAN MNEMONIC TABLE 


SVC 2 code 17 compares a user-specified mnemonic character string 
to a table of previously defined mnemonic strings. If a match is 
found, the user-specified mnemonic character string is accepted 
as avalid mnemonic. The SVC 2 code 17 parameter block is shown 
in Figure 3-19. 


i NN ee a i I Ee eee ee i he neat ee celled 


10(0) }1(1) |2(2) 13(3) | 
{ Option Code i User User 
H { register 1 {| register 2 | 
a Se ane ean a Pa a oan ee ee a eT ee ee 
14(4) | 
| Address of mnemonic table H 
! ! 
{ { 

svc 2,parblk 

ALIGN 4 

parblk DB 0,17 
DB user register 1, user register 2 


DCF A(mnemonic table) 


Figure 3-19 SVC 2 Code 17 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in atask writable segment. A 
general description of each field in the parameter block follows. 
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Fields: 


Option is a l-byte field that must contain O to 
indicate no options for this call. 

Code is a l-byte field that must contain the 
decimal number 17 to indicate code 17 of SVC 
23 

User is a l-byte field that must contain a user- 

register 1 specified register number. This register 


should contain the starting address of the 
buffer with the user-specified mnemonic 
character string. After executing SVC 2 code 
17, this register contains the address of the 
byte following the user-specified mnemonic 
string, or the unchanged starting address. 


User is a l-byte field that must’ contain a user- 
register 2 specified register number. This register 
receives a decimal number from -1 through 
2,147,483,647 (23' -1) corresponding to the 
position of the mnemonic within the table that 
matches the user-specified mnemonic character 
string. If no match is found, this’ register 
receives a value of -l. The first position in 
the mnemonic table corresponds to a value of 


0. 
Address of is a 4-byte field that must contain the 
mnemonic starting address of the mnemonic table. This 
table must be defined before executing SVC 2 code 17. 


The user-specified mnemonic character string can be any length 
but can contain only the following characters: 

e A through Z (uppercase) 

@ a through z (lowercase) 


e 0O through 9 (can be used only after the first byte of the 
mnemonic) 


e Special characters (can be used only as the first byte of the 


mnemonic). 


All lowercase characters that appear in the user-specified 
mnemonic character string are accepted as their uppercase 
equivalent. 
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3.15.1 Building a Mnemonic Table 


The mnemonic table to be used in SVC 2 code 17 must be defined in 
a standard format. The mnemonics entered in the table can be any 
length but can contain only certain legal characters: 


e A through Z (uppercase alphabetics) 


e O through 9 (numerics can be used only after the first byte of 
the mnemonic) 


e@e Special charactors can be used only as the first byte of the 
mnemonic) 


The characters for each mnemonic in the table must be in 
contiguous order, beginning with the first character and ending 
with the termination indicator, X'00'. Every mnemonic entered in 
the table has a minimum abbreviation. Each character required 
for the minimum abbreviation must have an X'80' added to the 
character when the mnemonic is defined. The mnemonic table must 
be terminated by an X'O00' after the last mnemonic entry. See the 
example below. 


Example: 
TABLE EQU x 
DB C*G* +X*s0",,C* ET", x*00"* 
DB C'R'+X'80',C'E'+X'80',C'W'+X'80',C'IND',X'OO' 
DB C'S'+X'80',C'T'+X'80',C'ART',X'OO' 
DB x'OOo' 


When the table is assembled, a logical OR operation is performed 
on X‘'80' and the character associated with it. This sets bit 0 
of each character on which the OR operation was performed to 1. 
A bit setting of 1 indicates that it is a required character; 
whereas, a bit setting of O indicates that it is not a_ required 
character. 


3.15.2 Executing SVC 2 Code 17 


When executing this call, the user-specified mnemonic’ character 
string is compared to each entry in the mnemonic table until a 
match is found. Once a match is found, the address of the byte 
following the user-specified mnemonic character string is stored 
in user register 1 specified in the parameter block. 
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The mnemonic's position (decimal number) within the table that 
matched the user-specified mnemonic character string is stored in 
user register 2, specified in the parameter block. After 
executing SVC 2 code 17, the condition code is set. 


Condition codes 


fcrviGciLt 
H as ee ee 
;o1ror;oro} 
! 


Normal termination 
' 


( 
; O } 1 tO; O | User-specified mnemonic character string 
Th ae aS ae does not match any mnemonic in the table. 


Example: 

LA 3,STRING 
SVC 2,SCAN 
SVC 2, PAUSE 
ALIGN 4 

SCAN DB 0,17 
DB 3,5 
DC A( TABLE ) 

STRING DB C'map' 
ALIGN 4 

PAUSE DB 0,1 

TABLE EQU * 
DB C'A'+X'80',C'L'+X'80',C'LOCATE',X'O0' 
DB C'M'+X'80',C'A'+X'80',C'P'+X'80',X'00 
DB C'T'+X'80',C'YPE',X'OO' 
DB X'OO' 


User-specified mnemonic string before and after execution of 
SVC 2 code 17 


Starting 
address 
X'158' 


ee ee 
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Table (after assembly) before and after execution of SVC 2 code 
17. 


ic Lic Ci4 Ci4 Fi4 374 115 4/4 540 OC DiC 1{D OjO OF} 


mt ee ne ee ae Se ec SS DS ee ee cme ee ee ee ee oe ee en eee ee 


User register 1 before execution of SVC 2 code 17 


ea A ce ee ee oo oo 


10 0;O0 O;O0 1/5 8{ Hex 


et ne Se ce 


a ees ree eee oe ee ee ee om 


10 O;0 OO 1;5 BY Hex 


ae emt cs ee cD ee nem kee eet 


User register 2 after execution of SVC 2 code 17 


eee ne ee ee ee ee ee ie oe 


Q 
< 
(7 


Oo 
Oo 


ee eee eee ce ee es 


If the user-specified mnemonic character string is compared to 
each entry in the mnemonic table and no match is found, the 
starting address of the buffer containing the user-specified 
mnemonic character string remains unchanged in user register l. 
A decimal value of -1 is stored in user register 2 and the 
condition code is set to 4 (V bit set). 
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Example: 


SCAN DB 


STRING DC 


PAUSE DB 
TABLE EQU 


User-specified mnemonic string before and after execution of 


SVC 2 code 17 


Starting 
address 
xX'158! 


14 115 3} ASCII 


code 17 


3,STRING 
2,SCAN 
2, PAUSE 


4 

0,17 

3,5 

A( TABLE) 
C'AS' 

4 


0,1 
x 


C'A'+X'80',C'L'+X'80',C'LOCATE',X'OO' 
C'M'+X'80',C'A'+X'80',C'P'+X'80',X'00' 


C'T'+X'80',C'YPE' ,x'O0OO0' 


etic iene tee ee Re A ee en ee ee 


iC LIC Ci4 Ci4 Fi4 314 1/5 4/4 530 O/C Dic 1iD O}O O 


: 
: 
: 
: 


' rrr reer een | 


iD 415 935 O14 5140 Of0 O} 


iT i ¥ | P {| BE {0 O;FO O} 


A A a ee A Re ON eR Sa A ne eS ce em US SAE SS Se ee elm ne ee OE fee ee nom meme fei MD eee mem wees um oe 


10 0;0 O/0 11/5 8] Hex 
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M 


code 17 


User register 2 after execution of SVC 2 code 17 


IF FiF FiF FiF Fj Hex 


Condition code 


a eee ee er err | 


=a 
‘ 
: 


a en ee eee Breer 


If a nonalphanumeric character follows the first character in a 
user-specified mnemonic string, the nonalphanumeric character is 
treated as the end of the mnemonic. The address of the 
nonalphanumeric character is returned to user register 1. 


Example: 

LA 3,STRING 
svc 2,SCAN 
SVC 2, PAUSE 
ALIGN 4 

SCAN DB 0,17 
DB 3:5 
DC A( TABLE) 

STRING DB C'TY&E' 
ALIGN 4 

PAUSE DB 0,1 
ALIGN 4 

TABLE EQU * 
DB C'A'+X'80',C'L'+X'80',C'LOCATE',X'0OO' 
DB C'M'+X'80',C'A'’+X"80',C'P'+X'80',X'OO' 
DB C'T'+X'80',C'YPE',X'OOOO' 


User-specified string before and after execution of SVC 2 code 17 
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Starting 
address 


X'158' xX'15A' 


17 


A NS NE SOR Mee SD TED rT ED MED oem ore ne MRED Her NORE Hime met mt AE FO SOO ee eee mS GE A es mm Se mE a em ee ee oe me oe mee, 


iC Lic Ci4 Ci4 Fi4 334 115 4/4 510 O'C DIC LID Oj{O Oj 


Fal ae ate ocala Rceane cee chee Reread enn een ene ett Ee Me De ee ey 


10 0/0 O10 115 8 


Hex 


CN ee 


10 0;0 0:0 1:5 Ai Hex 


execution of SVC 2 code 17 


ea ee NY ee i ee ee 


i0 oie oe O;0 2} Hex 
Condition code 

(Ci Vi GitL | 

| SSS SSS SSS SSS SS ' 

iO; OO; O07; 0} 
In the above example, the user-specified mnemonic "TY&E" is 
treated as TY". The address of the byte following the 
user-specified mnemonic string mnemonic string is then X'15A', 


A decimal value of 2 is 
and the condition code is set to 0. 


which is returned to user register l. 
stored in user register 2, 
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fi sve 2 | 


Q 
Oo 
0 
ti 
a] 
© 


3.16 SVC 2 CODE 18: MOVE ASCII CHARACTERS 
SVC 2 code 18 moves a specified number of ASCII characters’ from 


a sending buffer to a receiving buffer in memory. The SVC 2 code 
18 parameter block is shown in Figure 3-20. 


ae A A ee Le ee Gee GRE SE OU iS eS RS ee a ee re cn ee eS ms ee ee cme ene ee ee 


11(1) 12(2) 13(3) | 

Opt iontn Code User User 
i \ i register l1 { register 2 | 
ia gine iii 9 cin wee ae oe a a ee em ed ei ca 
14(4) | 
H Address of terminating character string H 
i $ 
( i 

SVC 2,parblk 

ALIGN 4 

parblk DB optiontn, 18 
DB user register 1, user register 2 


DCF A(terminating character string) 


Figure 3-20 SVC 2 Code 18 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 
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Fields: 


Optiontn 


Code 


User 
register 1 


User 
register 2 


Address of 
terminating 
character 
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is a l-byte field that must contain the 
addition of the hexadecimal number specified 
for the option and the decimal number 
specified as n. 


e n is a decimal number ranging from 0 
through 127 indicating an explicit number 
of bytes in the ASCII character string that 
are to be moved to the receiving buffer in 
memory . 


e Option X'OO'+n means no terminating 
character string is used. 


e® Option X'80'+n means a terminating 
character string is used. 


is a l-byte field that must contain the 
Gecimal number 18 to indicate code 18 of SVC 
2. 


is a l-byte field that must’ contain a user- 
specified register number. This register must 
contain the starting address of the buffer 
containing the user-specified ASCII character 
string to be moved. After executing SVC 2 
code 18, this register contains the address of 
the byte in the sending buffer that follows 
the last moved character. 


is a l-byte field that must contain a user- 
specified register number. This register must 
contain the starting address of the buffer 
that receives the user-specified number of 
ASCII characters being sent. This buffer must 
be located in a task writable segment. After 
executing SVC 2 code 18, this’ register 
contains the address of the byte in the 
receiving buffer that follows the last 
character received. 


is a 4-byte field that must contain the 
starting address of the user-specified string 
of terminating characters. Each character of 
this string can be used to indicate the end of 
the ASCII character string to be moved. This 
field is only used when option xX'80' is 
specified. 


When SVC 2 code 18 is executed, the specified number of ASCII 
characters are moved to the receiving buffer. The starting 
addresses of the sending and receiving buffers located in the 
user-specified registers are changed to the address following the 
last byte sent in the sending buffer and the last byte received 
in the receiving buffer. The condition code is also set after 
executing SVC 2 code 18. The possible condition code settings 
are: 


Condition code 


— a a ee me ee 


fCciviGitL | 

\oe eae eeesee | 

; O +; O ; O | O {| Normal termination 

Pee soe eae eset | 

; oO} 21:0; O | No terminating character found in 


eal nek ett Mae a eich -- the ASCII character string 


3.16.1 SVC 2 Code 18, Option X‘'O0O'+t+n 


If option X'OO'+tn is used with a user-specified decimal number, 
that decimal number determines the number of bytes moved from the 
ASCII character string to the receiving buffer. After executing 
Svc 2 code 18, user register 1 contains the address of the byte 
in the sending buffer that follows the user-specified number of 
ASCII characters that were moved. User register 2 contains the 
address of the byte in the receiving buffer that follows the 
user-specified number of ASCII characters just received. The 
condition code is set to 0. 


Example: 
LA 1,ASTRING 
LA 2, RECBUF 
SVC 2,MOVECHAR 
ALIGN 4 
MOVECHAR DB X'O00'+17,18 
DB Lee 
DS 4 
ASTRING DB C'FLORIDA** *VERMONT' 
RECBUF DS 17 


User register 1 before execution of SVC 2 code 18 


— 


10 O00 OO 1/6 2{ Hex 
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User register 2 before execution of SVC 2 code 18 


:0 O00 O;0 1}7 3] Hex 


Te eliteieatioadieas Ede Meee ie 


ASCII character string before and after execution of SVC 2 code 18 


Starting address Last byte Address 
civa to be me hae 


ere cme ce ae me ee ee ee me ee es ete cae mre eee ee ee cee ce wee re ee wee ee ag es ee ee ee ee eee ee ee ee ee ee ee ee ee ee eee ee - 


Oe ee ce ee ce ee ee cee ee ee ree ce Oe ee ee ee a eee ervey meee eee rm ee ce ete ee ee ee mee ee ee ce cee ee ee ee ee ee ee ee ee ee ee ee ee 


Receiving buffer after execution of SVC 2 code 18 


Starting address Address 
X'173' X'184' 


a a me ee ee ee eee wee wre we ee oe oe oe ee ee eee eee ee ee ee oe ee ee ee ee ea a ae ae a 


r 614 Ci4 FI5 214 914 4/4 1]2 Ai2 Aj2 AI5 614 5]{5 24/4 Dl4 Fl4 EJS 442 T ASCII 


User register 1 after execution of SVC 2 code 18 


ee 


;0 OFO0 OFO0 1/7 3) Hex 


oe cee cee Lae ee ne aD Swe NaN cee ene Me ee 


User register 2 after execution of SVC 2 code 18 


Se ee 


10 O/0 O;O 1/8 41 Hex 


See ee ee 


Se eee Ne ee Rem oR A cmt ND NO a ee om 


oO 
oO 


ee eee Ne owe SD nee me 


48-038 FOO RO1 3-85 


3.16.2 SVC 2 Code 18, Option X'80'+n 


If option X'80'tn is specified, each character in the ASCII 
string is compared to each character in the terminating string 
before it is moved. A match indicates that the end of the ASCII 
character string to be moved was reached and the decimal number 
n, which specifies the number of characters to be moved, is 
ignored. The character or characters in the ASCII string that 
match the character or characters in the terminating string are 
not moved, and the SVC terminates. The condition code is set to 
0. 


The string of terminating characters can be any length and can 
contain any character but must be specified by the user as 
follows: 


Format: 
label DB m,C'xxx...x' 
Parameters: 


label is the name of the terminating character 
string the user specifies. 


DB is the operation code, define byte. 

m is a decimal number indicating the number of 
characters in the terminating character 
string. 

C XXX 4. x. is a character string indicating that the data 
enclosed in the single quotation marks are 
characters. 
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Example: 


LA 3,ASTRING 
LA 5, RECBUF 
SVC 2,MOVECHAR 
svc 2,PAUSE 
ALIGN 4 
PAUSE DB 0,1 
ALIGN 4 
MOVECHAR DB X'80'+17,18 
DB 3,5 
Dc A(TSTRING) 
TSTRING DB 3,C'/&*! 
ASTRING DB C'FLORIDA*&/VERMONT! 
RECBUF DB 17 


ASCII character string before and after 


Starting 
address 
X'162' 


Characters matching 
terminating character string 


Address 
X'173' 


r 644 Cj4 Fi5 244 9{4 4/4 1)2 Al2 6{2 FI5 644 51/5 244 Di4 Fij4 E{5 432 01 ASCII 


10 O10 O}0 1/6 2} 


ee ee Se Se eee ee ee ee eee ee ee ee 


10 Of0 OFO 1}7 3} 
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Hex 


Hex 


execution of SVC 2 code 18 


Receiving buffer after execution of SVC code 18 


Starting address Address 
X‘'173' X'17A' 


| 
;P?}LEOtRI TIDIAI | | | i i | | i | i | 


User register 1 after execution of SVC 2 code 18 


a ee ate a oY atc eel 


i0 010 Of0 1/6 9} Hex 


ee ee ee ats ee ee ne RY 


User register 2 after execution of SVC 2 code 18 


i0 O}O0 O;O 1}7 Al Hex 


Terminating character string before and after execution of SVC 2 
code 18 


12 Aj2 6{2 F{ ASCII 


If option X'80' is specified and the ASCII character string does 
not contain any characters that match any terminating character, 
the decimal number specified as m determines the number of bytes 
to be moved. The condition code is set to 4 (V bit set). 
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Example: 


LA 3,ASTRING 
LA 5, RECBUF 
SVC 2,MOVECHAR 
svc 2, PAUSE 


ALIGN 4 
PAUSE DB 0,1 
ALIGN 4 
MOVECHAR DB X'80' + 17,18 
DB 3,5 
pc A(TSTRING) 
TSTRING DB 3,C',$:' 
ASTRING DB C'FLORIDA*&/VERMONT' 
RECBUF DS 17 


ASCII character string before and after execution of SVC 2 code 18 


Starting 
address Last byte Address 
Xx'162' to be moved. X'173' 


Ne 


14 644 Cl4 Fi5 21:4 914 454 1li2 Ai2 642 Fis 614 545 2/4 Di4 Fi4 E/5 4{2 ee ASCII 


—— 


10 0/0 O;O0 1};6 2{ Hex 


a 


i;0 O0;O0 Of0 1/7 3; Hex 


ee ee ee 
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Receiving buffer after execution of SVC code 18 


Starting 
address 
X'173! 


ee ee ee ee ee ee se 


ee ee ee SL NY eS roms me Se ee ee 


10 O10 O00 1;7 4] Hex 


10 Oj0 OO 1/8 4; Hex 


12 712 443 Al ASCII 


(C7 VviGeLy 
|, Seca scereeze ss | 
iO; lio? odt 


ee ee ee ee 


execution of SVC 2 code 18 


execution of SVC 2 code 18 


string 
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; Sve 2 | 
i 
i 


3.17 SVC 2 CODE 19: PEEK 


SVC 2 code 19 provides four parameter block options that can _ be 
used to obtain and store task related information. Each 
parameter block option obtains a different set of information 
from the system pointer table (SPT) and the task control block 
(TCB). Figures 3-21 through 3-25 illustrate the five peek 
parameter block option formats. 


3.17.1 Parameter Block for Option X'‘'00' 
If SvC 2 code 19 is executed with option X'00' specified in the 


parameter block option field, use the parameter block format in 
Figure 3-21. This option is used to obtain task information. 


10(0 {1(1) {2(2) Number of {3(3) Maximum | 
H Option | Code {logical units | priority | 
| | (NLU ) i (MPRI) 
Oi tc se ge ge eR ee eB ep ee eT EEE CR Ee ae PE ee eee WE TT Bate CG eg Te ee j 
14(4) H 
! : | 
i Name of operating system | 
a aac a (OSTD}.:* ~~ .- (| -SeRRe esterase eee { 
18(8) i 
| i 
i | 
[SSS SS SSSR eS ae ee ee aS eer SS err 1 
}12(C) H 
| i 
| | 
[oS Sse -Ssees-=e> Task nmam@ rrr rrr rrr 1 
116(10) H 
H 1 
| i 
a ee ee a ee a a a | 
{20(14) H 
H Current task status word H 
H (CTSW) | 
[eset Se Sse ean aes ee ae SSeS eS er ret Rees eee eee er ee i 
124(18) }26(1A) {27(1B) | 
{ Task options | Logical | | 
{ (OPT) H Processor H Reserved } 
H | Unit (LPU) | | 

svc 2,parblk 

ALIGN 4 

parblk DB x'00',19 
DS 25 
DB 0 


Figure 3-21 SVC 2 Code 19 Parameter Block Format and Coding 
for Option X'O00' 
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This parameter block must be 28 bytes long, fullword-boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 


Option 


Code 


Number of 
logical units 
(NLU) 


Max imum 
priority 
(MPRI ) 


Name of 
operating 
system 
(OSID) 


Task name 
Current task 
status word 


(CTSW) 


Task options 
(OPT) 


Logical 
processing 
Unit (LPU) 


Reserved 


is a l-byte field that must contain the 
hexadecimal number X'OO'. 


is a 1l-byte field that must contain the 
decimal number 19 to indicate code 19 of SVC 
2. 


is a l-byte field that receives from the TCB 
the maximum logical unit number which can 
be assigned to a task. This hexadecimal 
number ranges from 0 through 254 (X'FE'). 


is a l-byte field that receives from the TCB 
the highest priority number at which the 
assigned task can execute. This hexadecimal 
number ranges from 10 (X‘'04') through 249 
(X'F9O'). 


is an 8-byte field that receives from the 
SPT the operating system name in ASCII. 


is an 8-byte field that receives from the TCB 
the name of the task in ASCII. 


is a 4-byte field that receives from the TCB 
the hexadecimal number representing bits 0 
through 31 of the CTSW. 


is a 2-byte field that receives the 
hexadecimal number representing bits 16 
through 31 of the option field in the TCB. 
Bits O through 15 are accessible through 
option xX'0O3' of SVC 2 code 19. Table 3-4 
lists task options. 


is a l-byte field that receives’ the hex- 
adecimal number of the task's current LPU 
assignment from the TCB. The value of this 
number ranges from X'O0O' through X'09'; xX‘'OO' 
indicates the central processing unit (CPU). 


is a reserved 2-byte field that must’ contain 
zeros. 
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TABLE 3 


Dee enn en ee ee eee 


BIT 


Oo 


mm Te ee i en ree nr ner enn ee ec Oe CT rte te es 


ome 


| A NS A a AN oe NN FON UND Ae om em Mm cm ey Ste eee me see RR Sm Stes rn mn me em Se ED RA rummy UR TD A rset crm ane taney A rh rm ene a 


No 
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-3 
BIT NAME 
AND MASK 


Diagnostic task 
(d-task) 
(Y'8000 O0000') 


APU only 
(¥'4000 0000') 


APU 
mapping option 
(Y¥'2000 0000') 


APU 
control option 
(Y¥'1000 0000‘) 


Dynamic 
priority 
scheduling 
(Y'O0800 O0000') 


Prompts 


Vertical forms 
control 
(Y'O2000000' ) 


Extended SVC 1 
parameter block 
(Y¥'O01000000' ) 


Task event 
service 
(Y'OO800000' ) 


Task event 
registers save 
(¥'00400000' ) 


Task event 
register save 
(Y¥'OO200000' ) 


TASK OPTIONS FROM THE TASK CONTROL BLOCK 


BIT SETTING AND MEANING 


Sees oaee se SST SES SS Ss SS SST SS SS SESS SSS 


task determined by bit 16 
task is a d-task 


task can run on CPU or APU 
task cannot run on CPU 


no APU mapping allowed 
task can perform APU 
mapping functions 


no APU control allowed 
task can perform APU 
mapping functions 


na em Re em LE a NR ose ka Re NNT SNH ee A cou AD Peey ER RN eeSEN'y amnesty terete mts mm mt ny me ome ee nme stem nem ee ene rem ee 


dynamic priority 
scheduling disabled 


= dynamic priority 


scheduling enabled 


MTM prompts diteabied 
MTM prompts enabled 


a i el 


except where specified, 
all I/O interpreted 
without forms control 
all I/O interpreted with 
vertical forms control 


A mR me coe mem meen ne em mm PO NS me cay eee em ems SRS a eee mm meer mee em yet cos sme mee ae et ie ewe eee ie me mee eee te nee 


SVC 1 extended 
block not used (excludes 
communications I/O). 
extended SVC 1 parameter 
block used 


parameter 


+m se en ewe raat om rae at cup somes SAEED su RMN Nun mS en anes em eth mS nese eRe mem ane see eee em erm em tem me Sec ee eee rem wm mh ee me ee 


new TSW for task event 
service 

no new TSW for task event 
service 


Ce ee i Ee ee ee 


all register contents 
saved and restored 

only contents of registers 
that contains task event 
Gata are saved and re- 
stored 


task event register not 
saved 
task event register saved 


TABLE 3-3 TASK OPTIONS FROM THE TASK CONTROL BLOCK (Continued) 


ee ne rm NYO AOR OS mes une ME ot ON mmm mms mmm em eee ce me ce ee ee mee ee eee ee ee ee ee ee 


BIT H BIT NAME I H 

i POSITION | AND MASK H BIT SETTING AND MEANING H 

|eaaeceese sess SSeS SSR SSS SSSR SEC SS eee Eee Ee eee ee cess | 

11 i System group i O = not in system group { 

H i (¥'O00100000') j; 1 = in system group H 
12 Console I/O 


{ i O = no console I/O interrupt 
i intercept i l= 

i j 

' i 


console I/O interrupt H 
(Y'O0O0080000' ) i 


enable (MTM) 


( 
13 | Universal i O = universal task status re- jj; 
H | status report jj ports not allowed ' 
H i (Y¥'O00040000' ) i; lL = universal task status re- : 
H H H ports allowed H 
(cascade seated sie clang es ake aimed A cae ai a An ae | 
14 | Executive task {| 0 = allow e-task load 
| | load i lL = prevent e-task load H 
' i (Y'OOO20000' ) ' H 
paR ae Rae ee ene ee ee Seen as cornea 
i 15 { Queued I/O i O = queued [/O not purged on H 
i (¥'O0010000') |} error 
‘ \ i L = queued [I/O purged on Sree 
Nasri isi a a acme pce iesumegies ie ia a tee aaa ON toes eae 
16 | Executive task {| O = task is a u-task 
i 1 (¥'80000000' ) i; 1 = task is an e-task i 
(Sea SS PERS ae ee eee eee ee a er ee err ne Se eee ee { 
; 17 i Arithmetic | O = task abnormally Peuminates i 
H ! fault H on arithmetic fault H 
' i (€Y¥'400000000') | 1 = task continues execution H 
' i | on arithmetic fault i 
ee SSS ee Se ae See ae ae ee eS ee a Se ea ee H 
H 18 | Single i O = task does not support { 
| precision { single precision floating |} 
\ | floating point | point ' 
H + (¥'20000000' ) i 1 = task does support single \ 
i i } precision floating point } 
[ey ee eS eae ee eae eee ne ee 
19 i Memory resident; O = task is nonresident 
H + (Y¥'10000000' ) ' 1 = task is resident in memory H 
H Seco Sc seb GS-21 2 ibe Spee spe? et lc Sn emer Si "i ess Ee" c's ek" Sb ‘el Ce ites CoS. "sei esc ts te ess a‘ nw Sin Zs i ie, ai Sat: acd i 
H 20 i; SVC 6 control } O = task can execute all SVC H 
i } functions H 6 control functions i 
{ i; (Y'O8000000' ) i} 1 = all SVC 6 control functions!} 
{ H \ are pEevenved H 
passe Soe eS SS SS Se SS Se ee Se See Sa eee eS eee See { 
i 21 i SVC 6 communi- | O = task can execute all SVC H 
i | cation func- \ 6 communication functions H 
H i tions l = all SVC 6 communication H 
{ i (¥'O04000000' ) H functions are prevented i 


Cee cc ie i ee 
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TABLE 3-3 TASK OPTIONS FROM THE TASK CONTROL BLOCK (Continued) 


saat te ome re: Nene See mt RED SUES SRO DSRS SRO Sm ey oem meee ree mes nm me ee re me mm cere ees me mem nee eee em ene ee ee em ee ee 


BIT H 
POSITION ; 


22 { 
| 


BIT NAME 
AND MASK 


Illegal SVC 6 
(Y'O2000000' ) 


Double 
precision 
floating point 
(Y¥'O01000000' ) 


Rollable 
(¥'OO800000' ) 


Over lays 
(¥'00400000' ) 


Accounting 
facility 
(Y¥'O00200000' ) 


Intercept calls 
(Y¥'04000000° ) 


Account number 
privileges 
(Y¥'OOO80000' ) 


Bare disk I/0 
privilege 
(Y'00040000' ) 


Universal 
communications 
task 
(Y¥'O00020000' ) 


Executive task 
Keys 
(Y¥'O00010000! ) 


0 


se SS SS SES SES SES SSS SS SS SE TT SE SS ES 


task abnormally terminate 
on an illegal SVC 6 
task continues execution 
on an illegal SVC 6 


task does not support 
double precision floating 
point 

task does support double 
precision floating point 


ae eciiceeeiirseeeliaeee/ilseetiioeeeticnse diene oncati Times ae I eee een eee eee teeta rie Mae Diane elie el mel Mes NE a ree re Re ce nl eae 


task is not rollable 
task is rollable 


task does not support the 
use of overlays 

task does support the use 
of overlays 


disable accounting 
facility 


enable accounting facility 


task cannot issue intercept 


calls 
task can issue intercept 
calls 


task does not have file 
account number privileges 
task has file account 
number privileges 


task cannot directly 
assign to a disk device 
task can directly assign 
to a disk device for bare 
Gdisk I/O. See Chapter 8 


task is not a universal 
task 
task is a universal task 


no Keys are checked on an 
assign for an e-task. 
keys are checked on an 
assign for an e-task 


S 


ae elicit ie ie A I I Te ei het taetaeetaediened 


48-038 FOO ROL 


Example: 


SVC 2, PEEK 


ALI 
PEEK DB 
DS 
DB 


Parameter block 


100 {13 {OF {81 


ee ee ee ee ee 


Oe ee ee 


OC84= SVC 6 con 


GN 4 
X'00',19 
25 

0 


before execution of SVC 2 code 19 


after execution of SVC 2 code 19 


trol call prevented. 


SVC 6 communication call prevented. 


Task is rollable. 


SVC 6 load of executive task prevented. 
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3.17.2 Parameter Block for Option X'‘'Ol1' 


To execute SVC 2 code 19 with 
parameter block option field, 
Figure 3-22. 


ee OE ce Ne HO SN SO eS DS SE ce en eS Ym Oe ee aoe 


option X'Ol1' specified in the 
use the parameter block format in 


ee 


10(0) i1(1) 12(2) 
Option H Code { Maximum blocking factor 
! J ( i] 
Doe faa ee Se de So : 
14(4) 
' ' 
i ' 
H Name of operating system i 
SSeS Sees (OSID) See eaSS eS oeeeea | 
8(8) 
ee pee sem ce cs mmm Sas) me seme ine eh aes ems um rw reas emma, rm mn eh uO tm ch em em aig, mn mr as eh vt we Sem ee cae ome ec me nee me eee ce he ee i 
12(C) 14(E) 


level (OSUP) 


H 
i 
H 
( 
i 
H Operating system update 
t 
\ 
i 
H 
\ 


em me es meee cee rm remem mee meee ne cme mm ee ee mm me ree re ee ee 


16(10) ! 
System options H 
(SOPT) H 
cs Ms a eta at 4s es Cs se ims Sa ei eo si vs i tases Teen am a ea aa as “ea? ams ae, ag as Nam es aes ac ee eta ee Rae Se a a Fie Sa a ee tee a Sa : 
{20(14) 122(16) 
User account number i Group account number 
H (UACT) | (GACT) { 
t a ey ea, gins ec a a Sa essa yf, a inact tse pe cee es ba ee Se ah a i a in Rc H 
124(18) | 
H System console name 
i t 
1 { 
SVC 2,parblk 
ALIGN 4 
- parblk DB X'O1',19 
DS 26 


Figure 3-22 
for Option X'Ol1' 


This parameter block must be 


aligned, and located in a 


28 bytes 


SVC 2 Code 19 Parameter Block Format and Coding 


long, fullword-boundary 
task writable segment. A general 


description of each field in the parameter block follows. 
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Fields: 


Option 


Code 


Maximum 
blocking 
factor 


Name of 
operating 
system 
(OSID) 


Operating 
system update 
level (OSUP) 


CPU model 
numbers 


is a Il-byte field that must’ contain the 
hexadecimal number X'OL1'. 


is a l-byte field that must contain the 
decimal number 19 to indicate code 19 of SVC 
2s 


is a 2-byte field that receives a number 
ranging from xX'Ol' to X'FF'. This number 
indicates the maximum number of 256-byte 
segments that can be specified in an ALLOCATE 
command or an SVC 7 for the data block size of 
indexed files, and for the indexed block size 
for indexed, nonbuffered indexed, and 
extendable contiguous files. This blocking 
factor must be set at sysgen. See the System 
Generation/32 (Sysgen/32) Reference Manual. 


is an 8-byte field that receives from the 
SPT the operating system name in ASCII. 


is a 2-byte field that receives from the 
SPT the current update level of the operating 
system in ASCII in the form: nn. 

is a 2-byte field that receives from the SPT 
the model numbers in hexadecimal of the CPU 
used in the system. They are: 

@ Model 7/32 has a value of X'‘'0007'. 

@ Model 8/32 has a value of X'0008'. 

@ Model 3200MPS has a value of X'OC80' 

@e Model 3210 has a value of X'OC8A' 

@ Model 3220 has a value of X'0C94'. 

@ Model 3230 has a value of X'OC9E'. 

@e Model 3240 has a value of X'OCA8'. 

@ Model 3250 has a value of X'OCB2' 

is a 4-byte field that receives the 
hexadecimal value of bits O through 31 of the 


options field in the SPT. Table 3-4 lists 
system options. 
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User accou 
number 
(UACT) 


Group acco 
number 
(GACT) 


System 


nt 


unt 


console name 


is a 2-byte field that receives the user 
account number from the TCB. This hexadecimal 
number is right-justified with zeros’ filling 
the leftmost portion. 


is a 2-byte field that receives the group 
account number from the TCB. This hexadecimal 
number is right-justified with zeros filling 
the leftmost portion. 


is a 4-byte field that receives the name of 
the device that is acting as the system 
console. 


TABLE 3-4 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


CO Ne ee ee ee ee Meee 


H BIT H BIT NAME H | 
i POSITION | AND MASK H BIT SETTING AND MEANING H 
0 i Single i O = system does not support 
H { precision H single precision floating H 
H | floating point | point H 
H i (¥'8000 O000') {| 1 = system does support single jj; 
H | | precision floating point } 
{ in Su cas es as-is" i se as Saha’ is" i'n ni’ ro» mt neslihan a a ih es ae Soe Saad idan Neat nS, ---—| 
H 1 { Form date is | O = date is displayed in the H 
| displayed | form: mmddyy | 
H t (Y¥'4000 O0000') {| 1 = date is displayed in the 
4 } ‘ form: dadmmnyy 
So ea ee eee a ee a ee a ee ee 
! 2 | Time display | O = time is displayed on 
H ; (¥'2000 OOO00') } output device specified i 
H by the user 
i ; lL = time displayed on panel 
a Se ee ee ee ee ee a ee 
3 | Double i O = system does not support 
{ | precision | double precision floating H 
H | floating point | point { 
H i (Y¥'1000 O000') {| 1 = system does support double |; 
H H H precision floating point H 
[Rare SSS Sa Se aS SSS eae i a ae a re te eee ne ey et ae 
4 {| Writable ; O = system does not support WCS ; 
H } control store (} { 
i (WCS) i 1 = system does support WCS 
{ ' (¥'O800 OO00') } ! 
a a a aa a a ca a a laa ra ae a a i 
5 Address align- 0 = hardware does not support 
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ment 


(Y¥'0400 0000' ) 


error address alignment error 


1 = hardware supports address 
alignment error checking 


checking checking 
! ' 
! ! 


TABLE 3-4 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


(Cont inued ) 
i BIT H BIT NAME { H 
' POSITION ;| AND MASK { BIT SETTING AND MEANING H 
H SSE SSS SS SES SS SSS SEE SSS ESTES ESS TSS SSR ERATE SSS SHS SK HSS See Ses | 
6 i Direct access {| O = system does not support 
} i; (¥'O200 OO00') } Girect access t 
{| Ll = system supports direct 
H H H access | 
aaa a cya oer anes Saea cain anna aee ene a REE Oe GR ae ae 
7 i ITAM | O = system does not support 
i i (€Y¥'O100 OOOO') |} communications H 
{ | lL = system supports communica- | 
! tions. 
[See Se ee Se eS ae eS a ee ne a ae eee 
H 8 | Spool | O = system does not support 
H ' (¥'O0080 OOOO') |} spooling H 
{ i i 1 = system supports spooling H 
Ce a a ee ee er ee ee eee re ee pea mint 
H 9 | Roll i O = system does not support H 
H + (Y¥'O0040 OO000') } rollin, rollout | 
H H i 1 = system supports rollin, H 
H H H rollout 
| Res pS ea = Se eS aS eS ae a Se ear eS eee 
10 i Temporary files; 0 = system does not support 
H i €Y'OO20 OOOO') | temporary files 
| H i lL = system supports temporary H 
H H i files i 
Sorelle Wigimia c eunnenid oe ESS 5 RGN SS Ee RS a eA E | 
H 11 i Multiple i O = system does not support H 
1 | register sets |} multiple register sets 
H + (¥'O0010 OO00') ; 1 = system supports multiple 
register sets 
ec kaa a ea a ag a al nl ae id pa e| 
H 12 i Universal | O = intertask reporting between | 
H | reporting H universal tasks off 1 
{ t (¥'O0O008 OOO00') |} 1 = intertask reporting between | 
i | | universal tasks on | 
[SSS SPSS SSeS SSS SSeS Sie Se See Sse SSS Tes eS ae ee ee eae 
! 13 | General error ; O = general error recording off | 
| recording 
H i (¥'O0004 O0000') {| 1 = general error recording on | 
aan ci cirtairia ig = mi olp a amieint- tae gs taco embeds eae | 
H 14 | Memory error | O = memory error recording off H 
H | recording H H 
H i (¥'OOO2 OO00') | Ll = memory error recording on H 
LPR See Pes err ae a ee Sas So SS ae a ee ee 
i 15 ij Reserved i O = reserved for future use | 
(me ie an ed ag ge me NATE lg Pegg eee Veg Si te Oe ae ae OS re Ve ce te EG” en gee Ra ee a ' 
16 Load real 


O = load real address not | 
supported 
1 H 


1 ' 
{ ( 
| address H 
i H = load real address supported 


(Y¥'OO000 8000') 
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TABLE 3-4 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


not supported 


Ce es ee ed se 


(Cont inued) 
BIT BIT NAME 
{ POSITION | AND MASK BIT SETTING AND MEANING 
| HSS SPOS See SSS SS SS SS SS SSS SS SSS SSS SRS SSSR SSE SS SSE EEE ESE | 
H 17 | Memory | O = memory diagnostics 
H { AGiagnostics H supported 
{ i (¥'OO00O0 4000') | 1 = memory diagnostics 
' ‘ ' $ 
! | , ! 
18 | Processor modelj O = Model 7/32, 8/32 processors |; 
t (¥'OOOO 2000') | 
{| L = Model 3210, 3220, 3230, 
3240, 3250, 3200MPS 
H processors 
aa aa a aa aaa a a a cl a Sa a 
19 | MAT hardware {| 1 = system has MAT hardware 
H i (Y¥'OOO0O 1000') | O = system does not have MAT ' 
hardware 
A a a a a ak a ae a a aaa a 
20 ; Single pre- i 1 = single precision floating 
| cision float- | point software traps i 
{| ing point present 
H ;} traps i O = single precision floating i 
: (Y¥'O000 0800") |} point software traps not 
i present 
ce eeeiaciaia ad Manca Asiana ae ae radia as Sema ane eae ae ea 
21 {| Double precis- {| 1 = double precision floating 
| ion floating i point software traps 
| point traps present 
: (¥'O0000 0400') {| O = double precision floating i 
i point software traps not 
present 
eet eionetianteloasteerientnasinetentiateatasiealantestenteteenteetentetentaetcedentesientarton co ae ee ce ee oe ee ee ee ee ee re ee me ee ee ee me ee H 
31 i System debug i O = normal operation mode 
| mode 7 
i: (¥'O0000 O001') | L = system debug mode 
Example: 
SVC 2, PEEK 
SVC 2, PAUSE 
ALIGN 4 
PEEK DB X'O1',19 
DS 26 
ALIGN 4 
PAUSE DB 0,1 
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Parameter block before execution of SVC 2 code 19 


ot }13 {00 

}00 00 00 
100 00 OO 

100 00 100. 
}00 00 00° 
100 00 100, 
100 00 00 


00 | 
| 


— oe nee 


Parameter block after execution of SVC 2 code 19 


ee 


ve i 13 ;00 
ros 3. 
IM oto 
0 2 100. 


| 

{ 

1:00 91 ;,00 

Bo a a cs td ee 

t 

ri ee O N 
B2E08000= 

3-102 


FF | 
' 


Single precision floating point 

Time display on hexadecimal display panel 
Double precision floating point 

Direct access support 

Spooler option 

Roll option 

Temporary file support 

Multiple register set support 


Load read address support 
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3.17.3 Parameter Block for Option xX'02' 
If SVC 2 code 19 is executed with option X'02' specified in the 


parameter block option field, use the parameter block format in 
Figure 3-23. 


ee ee 


10(0) i1(1) 12(2) 
H Option Code H Reserved H 
(ie Sekine oe encima aecies cas eens Cae ae a | 
14(4) 
| 
| | 
oe aes eas Name of operating system -~-~--------------- 
18(8) | (OSID) 
i 
la ea a a a em maa aaa ane a rb 
112(C) 
i Load volume ! 
‘ ] 
ea es ! 
116(20) 
LSaeeSas ann aac Fidenam@ oo #=Se5eSsse'rSsss 34 
120(24) 
(tree SS ae ee ee eee ee ee Se ee ee 
'24(28) 127(31) 
H Extension i File class H 
! 1 { 
t t t 

SVC 2,parblk 

ALIGN 4 

parblk DB X'02',19 
DC H'O' 
DS 24 


Figure 3-23 SVC 2 Code 19 Parameter Block Format and Coding 
for Option Xx'02' 


48-038 FOO RO1 3-103 


This parameter block must be 28 bytes long, fullword-boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows: 


Fields: 

Option is a l-byte field that must contain the 
hexadecimal number X'02'. 

Code is a 1-byte field that must contain the 
decimal number 19 to indicate code 19 of SVC 
2 

Reserved is a 2-byte field that is reserved and must 
contain zeros. 

Name of is an 8-byte field that receives from the 

operating SPT the operating system name in ASCII. 

system (OSID) 

Load volume is the fd from which the task was loaded. The 

Filename fd can be used for subsequent assignments. 


Extension 
File class 


Example: 

SVC 2, PEEK 
SVC 2, PAUSE 
ALIGN 4 

PEEK DB X'02',19 
DC H'O' 
DS 24 
ALIGN 4 

PAUSE DB 0,1 
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Parameter block 


—— —— av ts ee Eee ED SE GD mS me cm eens oe 


oe 113 {00 00 
{00 00 00 00 
100 00 00 O00 
100 00 00 00 
100 00 00 00 
100 00 O00 900 
100 00 00 {00° 


ot ee rat see et seen seem nis errs ee 


ioe 113 ;00 O00 
fo 8 @ 2 
| M T 0 6 
iM 3 0 OF 
(SU POR 
! V I Ss R 
fo. & Vas. 


3.17.4 Parameter 


To execute SVC 2 
parameter 
Figure 3-24. 
on a task. 
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block 
This option is used to obtain extended 


before execution of SVC 2 code 19 


after execution of SVC 2 code 19 
| 
H 
H 
| 
H 
H 
! 
( 
Block for Option X'03' 
code 19 with option xX'03' specified in the 


option field, use the parameter block format in 
information 
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10(0) 11¢1) 12(2) Number 13(3) Maximum 
{ Option { Code | Of logical | priority 
H | ' units (lu) H (MPRI ) 
i as a a a CG as —seaesa- cese sme“, al acs nas RSs les Ted eed See sae mb msec Cnn "acs mip igs Ss “Ss “nes dnd, en Tak. “Nee, Celtel yd ese as 
14(4) 
H Taskid (TID) 
1 
Gta a ee he teed at eee ener tee Neate: Ny ee eee 
18(8) 
{ 
i 
(Hr SS=sssesSSee- Task name rrr rrr renee 
{12(C) 
{ 
{ 
{ et st. ah Ga sik, ly Sa wa AS elec Vm “Se” Wn inl“ er asm" Sin Sp ‘cao Ss Sig isl AGA sh Sl SS Sok <A ta“ lh 
116(10) 
{ Current task status word (CTSW) 
t 
Da aad cs ee et erate OS oA oe shee Spar tg hi ee ge 
120(14) 
{ Task options (OPT) 
4 
Bc ne DA ges ag ae sted ae aia fal oh te eet Ne Ma teats een a 
124(18) 
{ Task waits 
H 
H —_e eee ee ee eee www ew ww ww ew we ew ee ew ew ew ee ew wow ww ewe eww ww eww wee wee we ee 
128(1C) 
| User account number 
' 
Dace ete tt al tates Se are ee 
132(20) 
H Group account number (GACT) 
BS til aig cole tac ce alee hearin attest le te a 
136(24) 
t Load volume 
eC SLE SI SE I Pie ENTRAR OT rR NE A TT NT ET ETE 
140(28) 
1 
(2oSsSSSaSsSSes Filename 20000 2 222 w-rRrRRr rtm rt 
144(2C) 
1 
a gS Ce ils cate cay CmanwecmS ni e oe  i  Scm aa eas daces se em  e s 
148(30) 151(33) 
t Extension { File class 
i i 
152(34) 
H 
H 
ca a a Monitor task name = = ---~--------- 
156(38) 
j 
H 
160(3C) 
| Originating user console device (legacy) 
Fase teres te Peta hal bade het dachahan ae ete nae 
164(40) 165(41) | 66(42) | 67(43) 
{ Task | Reserved H LPU | Reserved 
H Priority H | H 
svc 2,parblk 
ALIGN 4 
parblk DB X'03',19 
DS 2 
DC Y'utask' 
DS 57 
DB 0 
DS 1 
DB 0 


Figure 3-24 SVC 2 Code 19 Parameter Block Format and Coding 
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for Option xX'03' 
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This parameter block must be 68 bytes long, fullword-boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 


Option 


Code 


Number of 
logical units 
(lu) 


Max imum 
priority 
(MPRI ) 


Taskid 
(TID) 


Task name 


Current task 
status 
word (CTSW) 


Task 


options 
(OPT) 
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is a l-byte field that must contain the 
hexadecimal number X'03'. 


is a l-byte field that must contain the 
decimal number 19 to indicate code 19 of SVC 
2 


is a l-byte field that receives from the 
TCB the maximum number of logical units 
which can be assigned to ae task. This 
hexadecimal number ranges from O (xX'OO') 
through 254 (X'FE'). 


is a l-byte field that receives from the 
TCB the highest priority number at which the 
assigned task can execute. This hexadecimal 
number ranges from 10 (X'OA') through 249 
(X'F9'). 


is a 4-byte field that contains a hexadecimal 
number, supplied by the user, that identifies 
the task for which the extended task 


information is being requested. The user 
obtains this number’ using the SVC intercept 
software. See the 0OS/32 System Level 


Programmer Reference Manual. The user's own 
task can be examined by setting the TID field 
to O. 


is an 8-byte field that receives from the TCB 
the name in ASCII of the task for which the 
extended task information is being requested. 
If the supplied TID is invalid, or the task no 
longer exists, the task name field is set to 
binary zeros. 


is a 4-byte field that receives from the 
TCB the hexadecimal number representing bits 
O through 31 of the CTSW. 


is a 4-byte field that receives from TCB 
the hexadecimal number representing bits 0 
through 31 of the task option field in the 
TCB. Table 3-4 lists task options. 
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Task waits 


User account 
number (UACT) 


Group account 
number (GACT) 


Load volume 
Filename 
Extension 
File class 


Monitor task 


name 


Originating 
user console 
device 
(legacy) 


Task priority 


Reserved 
Logical 


processing 
unit (LPU) 


Reserved 
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is a 4-byte field that receives the 
hexadecimal number representing bits O through 
31 of the task wait field in the TCB. Table 
3-6 lists the wait status bit definitions. 


is a 4-byte field that receives’ the user 
account number from the TCB. This hexadecimal 
number is right-justified. 


is a 4-byte field that’ receives 
account number from the TCB. 
number is right-justified. 


the group 
This hexadecimal 


is the fd from which the task was 
After the task is loaded, the fd 
assigned to subsequent tasks. 


loaded. 
can be 


the name of 
specified 


is an 8-byte field that receives 
the task that is monitoring the 
task. 


field that receives the name of 
the MTM console from which the specified 
task was loaded. If the task is not running 
under MTM, this field contains zeros. 


is a 4-byte 


is a l-byte field indicating the priority of 
the specified task at the time this call is 
executed. 


is a l-byte field that must contain zeros. 


is a l-byte field that receives the hexa- 
Gecimal number of the task's current LPU 
assignment from the TCB. The value of this 
number ranges from X'00' through X'09'; X'OO' 
indicates the CPU. 


is a l-byte reserved field that must 
zeros. 


contain 
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TABLE 3-5 TASK WAIT STATUS BIT DEFINITIONS 


ee er een i eat iil 


Caen ee reentrant ee A ee a a ee ae eae eed 


oe ne A NE OY ee A AR ce Ae SE EE coe ee me meee nee ae mee aie: GT com SE OO Gee Sm a GE oe Ge ee ce Ge ae ee ee a ee ee ee ee 


eerie timeeeti tie i a TE ee ee ee eee ee eld 


MEAN ING 


| Reserved 


A a hee neta ete 


{ BIT H 
Rl I thao 
| 0-14 { ¥'OQ000 OO000' 
15 { ¥'0001 0000! 
! 16 { ¥'OOO0O 8000' 
17 | ¥'OOOO 4000! 
18 it ¥'O0O000 2000! 
| 19 | ¥'OOOO 1000! 
| 20 } ¥'O0000 O800' 
! 21 + Y¥'OQ0000 0400' 
22 + Y'O000 0200! 
| 23 i Y¥'OOOO 0100' 
24 ;. ¥'0000 0080' 
| 25 | Y¥'O000 0040' 
26 ; ¥'OO000 0020! 
| 27 {| ¥'O0000 0010! 
28 ; ¥'O0000 O008' 
! 29 {| ¥'O0000 O0004' 
| 30 if Y'O0000 0002' 
31 ! Y'OO0O OOO1' 
If bits 0 to 30 
active. 
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NOTE 


are set to O, the task is 
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Example: 


2, PEEK 
2, PAUSE 


ALIGN 4 


sVC 
svc 


X'O3',19 


DB 
2 


PEEK 


x¥‘'OO' 
DS 57 


DS 
DC 


0 
1 
0 


DB 
DS 
DB 


Parameter block before execution of SVC 2 code 19 


Cee es 


00 


a ee ee ae Ne ee Ne Se 
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Parameter block after execution of SVC 2 code 19 


! 
i 
{00 00 O00 OO ; 
' 
i 


—_ eee ee ee ee ee ee eee ee 


eee eS 


3.17.5 Parameter Block for Option x'04' 


Option X'04' accesses the license number and current sysgen 
version of the operating system that is currently running on the 
system. To execute option X'04' of SVC 2 code 19, use the 
parameter block format shown in Figure 3-25. 
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—a ee me ee eee rem ee ee eee ree ee ee ee ee wre ree ee ee ee ee ee ee ee ee wee ee a 


Reserved 


12(2) 


ee me et er ee cee cee ee ee eee ee ee ee ee ee ee ee ee ee ee eee oe 
ee ee ee ee ee 


4(4) 


8(8) 


12(C) 


! 
! 
! 
i 
t 


16(10) 


OS 


20(14) 


License Number 


i 
| 
I 
! 
! 


24(18) 


28(1C) 


om es ree oe 


32(20) 


36(24) 


! 


! 
| 
| 
| 


OS Version Number 


40(28) 


2,parblk 


svc 


ae) 
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Oo 
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re 
mM 
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yO 
© = 
he 
wo 
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4 
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a) 
oOo OM 
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Ov 
UTD 
ie) 
NO 
+: 
wn 
w) 
a 
m 
1) 
bd 
sa 
wo 
om) 
Fey 
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This parameter block must be 44 bytes long, fullword-boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 

Option is a 1l-byte field that contains the 
hexadecimal number xX'04' indicating option 4 
of SVC 2 code 19. 

Code is a l-byte field that contains the decimal 
number 19 indicating code 19 of SVC 2. 

Reserved is a 2-byte field that should contain zeros. 

OS License is a 32-byte (8 fullwords) alphanumeric field 

Number that receives the license number of the 
operating system: e.g., License E-0178. Data 
in this field is left-justified with trailing 
ASCII blanks (X'20'). 

OS Version is an 8-byte (2 fullwords) alphanumeric field 

Number that receives the version of the operating 


system that was specified by the user at 
sysgen: e.g., 613C.819. Data in this field 
is left-justified with trailing ASCII blanks 
(X'20'). 
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{| Sve 2 | 


3.18 SVC 2 CODE 20: EXPAND ALLOCATION 


SVC 2 code 20 affects only those tasks running under. previous 
32-bit operating systems and should not be used in a multitasking 
environment. This SVC provides for compatibility with existing 
programs; no action is performed. The parameter block for this 
call is shown in Figure 3-26. 


ee ee ee ee ee se 


2(2) 


Oo 
ue) 
ct 
~ 
9) 
> 
Q 
0 
Q, 
tc) 
z 
c 
=) 
a 
@ 
nm 
Oo 
Ph 
No 
oi 
oO 
! 
oy 
< 
(ct 
fe) 
oy 
| md 
Oo 
OQ 
vr 
n 


SVC 2,parblk 


ALIGN 4 
parblk DB option, 20 
DC H'number of 256-byte blocks' 


Figure 3-26 SVC 2 Code 20 Parameter Block Format and Coding 
This parameter block is 4 bytes long, fullword-boundary aligned, 


and located in a task writable segment for option xX'80°. A 
general description of each field in the parameter block follows. 


Fields: 

Option is a l-byte field that must contain option 
X'O0O' or X'80'. 

Code is a 1l-byte field that must contain the 
decimal number 20 to indicate code 20 of SVC 
2s 

Number of is an unused 2 byte field. 

256-byte 

blocks 
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The condition code is set after executing SVC 2 code 20. 
Possible condition codes are: 


Condition codes 


Normal termination with option X'80' 
specified 
i; O; 1 {| O | O | Normal termination with otion X'O0' 
SSeS Sao ao specified 
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i Svc 2 
| CODE 21 


3.19 SVC 2 CODE 21: CONTRACT ALLOCATION 


SVC 2 code 21 affects only those tasks running under. previous 
32-bit operating systems and should not be used in a multitasking 
environment. This call provides for compatibility with existing 
user programs; no action is performed. The parameter block for 
this call is shown in Figure 3-27. 


10(0) {1(1) 12(2 
i Option Code i Number of 256-byte blocks | 
! ' ' ! 
{ U ' | 
svc 2,parblk 
ALIGN 4 
parblk DB 0,21 


DC H'number of 256-byte blocks' 
Figure 3-27 SVC 2 Code 21 Parameter Block Format and Coding 
This parameter block is 4 bytes long, fullword-boundary aligned, 


and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 

Option is a l-byte field that must contain a OO to 
indicate no options for this call. 

Code is a l-byte field that must contain the 
decimal number 21 to indicate code 21 of SVC 
2% 

Number of is an unused 2-byte field. 

256-byte 

blocks 
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| sve 2 | 
| CODE 23 | 


3.20 SVC 2 CODE 23: TIMER MANAGEMENT 

SVC 2 code 23 performs five timer management functions used _ in 

coordination with real time operations: 

1. Schedules the addition of a parameter to a task queue when a 
specified interval has elapsed (option X'00') 

2. Waits until completing a specified interval (option X'80') 


3. Schedules repetitive additions to a task queve as_ specified 
intervals elapse (option X'40') 


4. Reads time remaining for the specified interval (option 
X'20') 


5. Cancels a previous interval request (option X'10') 


Since the five options perform different functions, their 
parameter block formats and coding differ and are shown as 
separate parameter blocks. These operations are accomplished 


through the SVC 2 code 23 parameter blocks shown in Figures 3-28 
through 3-32. 


3.20.1 SVC 2 Code 23 Parameter Block for Option X'00' 


When specifying option xX'00', a timer interval is set up 
concurrently with the subsequent task executions. Then, an item 
with a reason code of X'09' is added to the calling task queue 
when the user-specified interval elapses. This is accomplished 
through the SVC 2 code 23 parameter block for option X'00' shown 
in Figure 3-28. See the 08/32 Application Level Programmer 
Reference Manual for information on the task queue. 
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i0(0) i1(1) 12(2) 13(3) 
' Option ' Code i Reserved iUser register | 
Caries ieee ein Sine Ane eee oe ee ee ae 
14(4) ! 
H Increment of timet+count { 
1 t 
( i 

SVC 2,parblk 

ALIGN 4 

parblk DB X'00',23,0 
DB user register 
DC Y' increment of time'+tF'count' 


Figure 3-28 SVC 2 Code 23 Parameter Block Format and Coding 
for Option xX‘O0' 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option 


Code 


Reserved 


User register 
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is a l-byte field that must contain the 
hexadecimal number X'OO'. 


is a 1l-byte field that must contain the 
decimal number 23 to indicate code 23 of SVC 
2: 


is a l-byte field that must contain a zero. 


is a l-byte field that must contain a user- 
specified register number. Bits 8 through 31 
of this register must contain the parameter 
portion of the item that is added to the task 
queue when the interval elapses. 
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Increment of is a 4-byte field that indicates the number 
timet+count of seconds or milliseconds that must elapse 
before an item is added to the task queue. 


The first four bits contain a hexadecimal 
number indicating how the time period is to be 
calculated: 


e Y'OOOO00000' indicates that the time is 
calculated in seconds from midnight (time 
of day). 


e Y¥'10000000'! indicates that the time is 
calculated in milliseconds’ from the time 
this call is executed (interval timing). 


The remaining bits contain the count Or 
decimal number indicating the number of 
seconds or milliseconds. 


A decimal number greater than 86,399 indicates 
Gays in the future. For a detailed 
explanation of time of day and interval 
timing, see Sections 3.11 and 3.12. 


Before executing this call, prepare the task to handle ae task 
queue trap. See the OS/32 Application Level Programmer Reference 
Manual. 


After the interval is started and the condition code is set, the 


task continues processing or enters a trap wait state. Possible 
condition codes are: 


Condition codes 


Interval started; normal termination 


. 
: 


Insufficient system space available 
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Example: 


LI 3,C'ABC' 
Svc 2,TIMRQ 
SVC 9,TRAPWAIT 


ALIGN 4 


TIMRQ DB X'O00',23,0 
DB 3 
DC Y¥'10000000'+F'30000' 
ALIGN 4 
TRAPWAIT DC X¥'88000200' 
DC Y'O' 


If this call is executed and insufficient system space is 
available, no time period elapses, no item is added to the task 
queue, and the condition code is set to 4 (V bit set). If this 
call is executed and the task is unprepared to handle this trap, 
no item is added to the task queue and the task has effectively 
lost an interrupt. 


If queue overflow occurs after the specified interval elapses, 
the end of task code is set to 1000 and the task terminates 
abnormally. 


If the interval is calculated as time of day and that specified 
time has already passed, the same time on the following day is 
assumed. 


3.20.2 SVC 2 Code 23 Parameter Block for Option X'80' 


If option X'80' is specified, the calling task is placed in a 
timer wait state until a specified interval elapses. Nothing is 
added to the calling task queue. This is accomplished through 
the SVC 2 code 23 parameter block for option X'80‘' shown in 
Figure 3-29. 
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Lenin ee oe A Renee enn et ee ee 


10(0) 11(1) 12(2) 
Option Code Reserved 
| | 
ae cease Se ay Sem Ss ie Sa escent ate St a es ss aaa a ats ca ah ee Sms ey a ha Sn Ye as et en oe es ' 
! { 
i(4) | 
Increment of timetcount 
' ! 
' I 

SVC 2,parblk 

ALIGN 4 

parblk DB X'80', 23 
DC H'O' 
DC Y'increment of time'+tF'count' 


Figure 3-29 SVC 2 Code 23 Parameter Block Format 


and Coding for Option X'‘'80' 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option 


Code 


Reserved 
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is a l1l-byte field that must contain the 
hexadecimal value X'80'. 


is a l-byte field that must contain the 
decimal number 23 to indicate code 23 of SVC 
2. 


is a reserved 2-byte field that must' contain 
zeros. 


3-121 


Increment of is a 4-byte field that indicates the number 


time+count of seconds or milliseconds that must’ elapse 
before the task is released from the wait 
state. The first four bits contain a 


hexadecimal number indicating how the time is 
to be calculated: 


e y'OOOO0000' indicates that the time is 
calculated in seconds from midnight (time 
of day). 


e Y'10000000! indicates that the time is 


calculated in milliseconds from the time 
this call is executed (interval timing). 


The remaining bits contain the count Or 


decimal number indicating the number of 
seconds or milliseconds. A decimal number 
greater than 86,399 indicates days in the 
future. 


After the specified interval elapses, the task resumes execution 
with the instruction following SVC 2. The possible condition 
codes are: 


Condition codes 


; O;O0O; 0; Of} Internal started; normal termination 
a ce a a ae a a ps \ 

; O;21;0; 0} Insufficient system space available; 
SSS aae Rare oes no wait occurred 


If this call is executed and insufficient system space is 
available, mo interval elapses, no item is added to the task 
queue, and the condition code is set to 4 (V bit set). 


If the interval is calculated as time of day and that’ specified 


time has already passed, the same time on the following day is 
assumed. 
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3.20.3 SVC 2 Code 23 Parameter Block for Option X'‘'40' 


If option X'40' is specified, items with reason code xX'O9' are 
repetitively added to the calling task queue at user-defined 
intervals within a specific time period until the task terminates 
or cancels the time interval request with SVC 2 code 23 option 
X'10. The user-defined intervals that are within a specific time 
period must all be specified the same way, either as time of day 
intervals or as interval timing intervals. This is accomplished 
through the SVC 2 code 23 parameter block for option X'40' shown 
in Figure 3-30. 


Ce ee eee en eee en ei eel ee eae ee ee cee ceed 


10(0) 11(1) 12(2) 
i Option H Code H Number of intervals i 
H i H defined in table i 
i= a i it a sa eso Wa ae lt a ek ts a ts flit eat ak at ae nts a te Pe aay a aa cs i seam ae Sai) a tl mc ew H 
14(4) ! 
H Increment of timetaddress of interval table ; 
i 1 
t | 

SVC 2,parblk 

ALIGN 4 

parblk DB X'40',23 
DC H'number of intervals defined in table' 
DC Y'increment of time'tA( interval table) 


Figure 3-30 SVC 2 Code 23 Parameter Block Format and Coding 
for Option x'40' 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in atask writable segment. A 
description of each field in the parameter block follows. 
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Fields: 


Option is a 1l-byte field that must contain the 
hexadecimal number X'40'. 

Code is a 1l-byte field that must contain the 
decimal number 23 to indicate code 23 SVC 2. 

Number of is a 2-byte field that must contain the 

intervals decimal number indicating the number of 

defined in intervals the user defined in the table. 

table 

Increment of is a 4-byte field that indicates the address 

timetaddress of the table containing all the user-defined 

of interval intervals within a specified time period. The 

table first four bits contain a hexadecimal number 


indicating how the time designated by the 
interval table is to be calculated: 


e Y'OOOOOOO00' indicates that the time is 
calculated in seconds from midnight (time 
of day). 


e Y'10000000'! indicates that the time is 
calculated in milliseconds from the time 
this call is executed (interval timing). 


The remaining bits contain a hexadecimal number indicating the 
address of the interval table. This table must be 
fullword-boundary aligned and defined as follows. 


Format: 
table DC F'count' First interval 
DC F'parameter' 
Dc F'count'! Second interval 
DC F'parameter' 
DC F'count! Last interval 
DC F'parameter' 
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Parameters: 


table is the user-specified name for the interval 
table. 
DC is the operation code, define constant, for 


the instruction. 


F is the type code, fullword, for the 
instruction. 
count is the decimal number indicating how many 


seconds or milliseconds must elapse before an 
item is added to the task queue. The decimal 
numbers specified for time of day intervals 
can be any number except 0 and must be 
specified in ascending order with each count 
at least one greater than the previous’ count. 
The decimal number for interval timing 
intervals can be any decimal number except 0. 
This decimal value occupies bits 4 through 3l 
of the count field. 


parameter is the item to be added to the task queue when 
its associated interval elapse. This item 
occupies bits 8 through 31 of one slot of the 
task queue. The first byte contains reason 
code xX‘'O9'. See the 0S/32 Application Level 
Programmer Reference Manual. 


The time period in which the user-defined intervals occur differs 
for time of day intervals and interval timing intervals. The 
time period for time of day intervals ranges from the day on 
which the first interval occurs through and including the day on 
which the last interval occurs. The time period is the sum of 
days on which the intervals occur. In the following example, the 
total time period is 3 days. 


Example: 
ALIGN 4 
INTABILE DC F'54000' 1500 hours of current day 

DC ae 

DC F'140399! 1500 hours of second day 
DC B* 2° 

DC F'227798' 1500 hours of third day 
DC F*3' 

DC F'231498' 1600 hours of third day 
DC F‘'4' 


The time period for interval timing is the sum of all intervals 
in the table. 
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Example: 


ALIGN 4 
INTABLE DC F'18000' first interval 
DC F'AL' 
DC F'36000' 
DC F'A2' second interval 
In the above example, the time period is equal to 54000 ms. The 


time period is repetitively executed until the task cancels the 
time interval request via SVC 2 code 23 option X'10' or goes to 
end of task. Before executing this call, prepare the task to 
handle this trap as described in the 0OS/32 Application Level 
Programmer Reference Manual. 


As the specified intervals are elapsing, the task can continue 
processing. After executing this call, the condition code is set 
to these possible settings: 


Condition codes 


i 
; Oo; O } O } O | Normal termination 
! : 


; Of; 1}; 0; O }; Insufficient system space available; 
ca aaa Sea SS no wait occurred 


If this call is executed and insufficient system space is 
available, no interval elapses, nothing is added to the task 
queue, and the condition code is set to 4 (V bit set). 


If this call is executed and the task is not prepared to handle 
this trap, nothing is added to the task queue. The task has 
effectively lost an interrupt. 


If queue overflow occurs after one of the specified intervals 
elapses, the end of task code is set to 1000 and the task 
terminates abnormally. 


If the time period is calculated as time of day and the specified 


time for the first interval has already passed, the same time in 


the following period is assumed. 
If the time period is calculated as time of day and one of the 


specified intervals in the interval table is O or not in 
ascending order, the task is paused and a message is displayed. 
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3.20.4 SVC 2 Code 23 Parameter Block for Option X'20' 


SVC 2 code 23 reads the time remaining until the _ interval 
previously established with option X'00' or X'40' elapses. This 
is accomplished through the SVC 2 code 23 parameter block for 
option X'20' shown in Figure 3-37. 


10(0) {1(1) 12(2) 13(3) 
Option Code Reserved iUser register | 
{ i 1 
| SAMS eae a ee Seas eaten eee re aes | 
14(4) 
H Time returned H 
{ 

SVC 2,parblk 

ALIGN 4 

parblk DB X'20',23,0 
DB user register 
DC Y' increment of time returned' 


Figure 3-31 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'20' 


This parameter block must be _ 8 bytes long, fullword-boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 

Option is a 1l-byte field that must contain the 
hexadecimal number X'20'. 

Code is a l-byte field that must contain the 
decimal number 23 to indicate code 23 of SVC 
ae 

Reserved is a l-byte field that must contain a 0. 
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User register is a l-byte field that must contain the user 
register number. Bits 8 through 31 of this 
register should contain the parameter 
associated with the desired starting interval. 


Time returned is a 4-byte field that contains a hexadecimal 
number indicating how the time will be 
returned for the type of interval being read, 
as follows: 


e Y'OOOOOO000' indicates the number of seconds 
from midnight specified for the time of day 
wait interval in the parameter block for 
option X'O00O' of SVC 2 code 23. 


e Y¥'10000000' '- indicates the milliseconds 
remaining from the time this call is 
executed to the completion of the time 
interval specified in the parameter block 
for option X'40' of SVC 2 code 23. 


NOTE 


If the timer entry that is being 
read is set for a time-of-day wait 
interval (option X'00'), only’ the 
value for the time-of-day interval 
can be read. An interval timing 
readout cannot be made for this 
task. Similarly, if the task is 
set for interval timing (option 
X'40'), only an interval readout 
can be made. 


The register in the user register field specifies the parameter 
associated with the interval to be read. When executed, this 
call finds the value of the time-of-day wait interval or the 
milliseconds remaining for a timing interval by searching for the 
parameter associated with the interval on the timer queue. The 
value read is stored in bits 4 through 31 of the Time Returned 
field. Bits O through 3 remain unchanged. Hence, the final 
value in the time returned field after execution of the SVC can 
be represented as follows: 


Time returned = increment of time + count 


If the interval was started with option X'40' specified and more 
than one interval in the table has the same parameter associated 
with it, the current time in the desired interval might not be 
the one that is read. Each interval must have a unique parameter 
associated with it. 
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After executing this call, the condition code is set to these 
possible condition codes: 


Condition codes 


rCiviGi Ly} 
;Ot?}o t}o } O {| Normal termination 
pa ll dnt ea 
+O} 1it04f% O | No interval associated with parameter 2 
SSeS Se located in user specified register 
Example: 
TESTL EQU 1 


LI 3,TEST1 
svc 2,TIMRQ 
SVC 2,RDTIME 
SVC 9, TRAPWAIT 


ALIGN 4 
RDT IME DB X'20',23,0,3 
DC ¥'10000000' 
ALIGN 4 
TIMRQ DB X'00',23,0,3 
DC Y¥'10000000'+F'90000' 


ALIGN 4 
TRAPWAIT DC Y¥'88000200' 
DC pal ea 


3.20.5 SVC 2 Code 23 Parameter Block for Option X'10' 


This SVC cancels an interval request that was previously 
established with option xX'0O0' or X'40'. This is accomplished 
through the SVC 2 parameter block for option X'10' shown in 
Figure 3-32. 
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ee eee ee ee me a ee ee ee ee ee ee ee ee ee ee ee eee ee eee 


i0(0) i l(1) i2(2) i3(3) i 
{ Option Code { Reserved {User register |} 
1 i ! ! § 
DE Naa pee he cee Raat aa dal ee lag ea a eae 
t 4 
14(4) ! 
H Increment of time cancelled i 
i { 
t { 

SVC 2,parblk 

ALIGN 4 

parblk DB X'10',23,0 
DB user register 
DC 


Y' increment of time cancelled' 


. Figure 3-32 SVC 2 Code 23 Parameter Block Format and Coding 
for Option X'10' 


This parameter block is 8 bytes long, fullword-boundary aligned, 
and does not have to be located in a task writable segment. A 
general description of each field in the parameter block follows: 


Fields: 


Option 


Code 


Reserved 


User register 
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is a 1-byte field that must contain the 
hexadecimal number X'10'. 


is a 1l-byte field that must contain the 
Gecimal number 23 to indicate code 23 of SVC 
2 


is a l-byte field that must contain a O. 
is a l-byte field that must contain the user 
register number. Bits 8 through 31 of this 


user register contain the parameter associated 
with the interval to be cancelled. 
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Increment of is a 4-byte field that must contain a 

time hexadecimal number indicating how time is 

cancelled being calculated for the interval to be 
cancelled. The increments of time are: 


e yY'OQOO000000' indicates seconds from midnight 
(time of day). 


e Y¥'10000000' indicates milliseconds from the 
time this call is executed (interval 
timing). 


When this call is executed, all previous interval requests that 
match both the increment of time specified and the parameter 
located in the user register are cancelled. If the interval to 
be cancelled is part of a periodic group, the entire time period 
is cancelled. 


After executing SVC 2 code 23, the condition code is set to these 
possible conditions: 


Condition codes 


jC ;y;Tvy~eGttL 4 

joer seeeeeeeses | 

io}; of; Of; O | Normal termination 

(See ee SSS 

; O; 21+ 0; 0 {| No previous interval request exists that 


pipe abe te sore eee matches the parameter provided 
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{| sve 2 | 


Q 
Oo 
0 
na) 
No 
rN 


3.21 SVC 2 CODE 24: SET ACCOUNTING INFORMATION 


SVC 2 code 24 stores eight bytes of user-supplied information in 
the ATF task completion or data overflow account records of the 
accounting transactions file (ATF). 
the SVC 2 code 24 parameter block shown in Figure 3-33. 


This is accomplished through 


me km ie nem neither cee crm ne cn ee a ce ee a a eM a ett em Seem Sm ca em te sme te em eee ne 


i1(1) i2(2) 
H Reserved H Code H Reserved 
i 
Sen <eeeainaneE Bante ae & ae a ae en SierEeerSaeees 
14(4) | 
i 
i 
eae SSS oaa= User-supplied information = ~----------~--- 
18(8) 

SVC 2,parblk 

ALIGN 4 

parblk DB 0,24 
DC H'O' | 
DC D'user-supplied information' 


Figure 3-33 


SVC 2 Code 24 Parameter Block Format and Coding 


This parameter block is 12 bytes long, fullword-boundary aligned, 
not have to be in a task writable segment. A general 
description of each field in the parameter block follows. 


and does 
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Fields: 


Reserved 


Code 


Reserved 


User-supplied 
information 


is a l-byte field that must contain a OO to 
indicate no options for this call. 


is a l-byte field that must contain the 
Gecimal number 24 to indicate code 24 of SVC 
2. 


is a reserved 2-byte field that must contain 
zeros. 


is an 8-byte field that must contain the user- 
supplied information to be stored in the ATF 
task completion or data overflow account 
records. 


If more than one SVC 2 code 24 is executed by a task, the 
user-supplied information in the last SVC 2 code 24 executed is 


stored in the ATF. 
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The condition code is always set to 0. 
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| Svc 2 


| 3.22 SVC 2 CODE 25: FETCH ACCOUNTING INFORMATION 
SVC 2 code 25 fetches task accounting information and stores it 
into a user-specified area. The accounting information accessed 
is: 
e User CPU time 
@ Operating system CPU time 
e Wait time 
@e Roll time 


This is accomplished through the SVC 2 code 25 parameter block 
i Shown in Figure 3-34. 


Nee ee Se 


10(0) il(¢l) i2(2) 13(3) 
Reserved { Code { Reserved iUser register } 
SVC 2,parblk 
ALIGN 4 
parbLk DB 0,25 
DB 0 
DB user register 


Figure 3-34 SVC 2 Code 25 Parameter Block Format and Coding 


This parameter block is 4 bytes long, fullword-boundary aligned, 
and does not have to be in a task writable segment. A general 
description of each field in the parameter block follows. 
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Fields: 


Reserved 


Code 


Reserved 


User register 


—— ee ee ee ee ee 


ee ee mee ee Re eS A ee 


ee A OE cee ee ee oe ee oe ee cee ee meee me ees ce arm me ee re come ee ee ee ee eee eee ee ee ee ee 


eee ee ee ee ee ee ee cee cee ee ee ewe eee ee ee ee ee ee ee ee ee ee ee 


is a l-byte field that must contain a 0 to 
indicate no options for this call. 


is a l-byte field that must contain the 
decimal number 25 to indicate code 25 of SVC 
2. 


is a reserved l-byte field that must’ contain 
a O. 


is a l-byte field that must contain a user- 
specified number of the register that contains 
the starting address of the area to receive 
the accounting information. This area is 
l6-bytes long, fullword-boundary aligned, and 
must be located in a task writable segment, as 
shown in -Figure 3-35. The condition code is 
always set to 0. 


cq 
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) 
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2 
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G 
ct 
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4) 
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meee ee ee ee we re ee eee ee ee ee ee eee ee we re ee ee ee eee ee eee ee ee oe 


w 
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p— 
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Figure 3-35 Area Receiving Accounting Information 
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f Svc 2 | 


3.23 SVC 2 CODE 29: UNPACK FILE DESCRIPTOR 


SVC 2 code 29 converts a packed file 


directory or 


an 


descriptor from the file 


SVC 7 parameter block to its unpacked format. 
The format for the SVC 2 code 29 parameter block is shown in 


Cel Eee 


1(1) 12(2) Source 13(3) Destina- | 
Code i Register jtion Register} 
(UPFD.COD) {| (UPFD.SRC) |; (UPFD.DST) | 

{ 

' 


Ce ee een ee ee ee ee 


Source Pointer 


(UPFD.SAD) 


4 
t 
for option x'Ol' 
( 
! 


Da Te 


{ 
UY 
Destination Pointer for option X'0Ol' 
J 
t 


(UPFD.DAD) 


een ee ee ee ee ee 


Figure 3-36. 

10(0) | 

Option 

{| (UPFD.OPT) |} 

J 

' 

i4(4) 

i8(8) 
svc 
ALIGN 

parblk DB 

DB 
DB 
DAC 
DAC 


2,parblk 


4 

option, 29 

source register 
destination register 
A(packed fd) 

BUFFADR 


Figure 3-36 SVC 2 Code 29 Parameter Block Format and Coding 


This parameter block is 12 bytes long, fullword-boundary aligned, 
and located in a task writable segment. 
each field on the parameter block follows. 
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A general description of 
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Fields: 


Option is a l-byte field that contains a hexadecimal 
(UPFD.OPT) number indicating one or more of the following 
SVC 2 code 29 option codes: 


Forces an account number 
(nnn) into the unpacked fd 
even if the file was 
allocated without account 


OPTION FUNCTIONAL 
CODE EQUATE MEAN I NG 
X'80' UPFO.NNN 
privileges. 
X'40' UPFO.PGS 


Forces a /P, /G, or /S 
account designation into the 
unpacked fd even if the file 
was allocated with account 
privileges. If the account 
number in the packed fd 
cannot be converted toa P, 
G, or S file class, P is 
returned to the unpacked fd 
and the G bit of the 
condition code is set. 


X'20' 
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NOTE 


If neither X'80' nor X'40' is specified, 
the fd will be packed according to the 
account privileges in effect when the 
file was allocated. 


UPFO.NOV Unpacks the fd in 
directory entry specified in 
the UPFD.SAD field. 
unpacked, the fd does 
include a volume name. 


NOTE 


If xX'20' is not specified, SVC 2 code 29 
will unpack the fd contained in the SVC 
7 parameter block whose address is 
specified by the UPFD.SRC or UPFD.SAD 
field. When unpacked, the fd includes a 
volume name. | 


file 


When 
not 
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X'10' 


X'08' 


X'OL1' 


UPFO.WID The unpacked fd includes any 


blanks that exist in the 
packed fd. If option xX'‘10' 
is not specified, all blanks 
are suppressed. 


UPFO.BLA The unpacked fd is formatted 


with blanks. If X'O8' is 
not specified, the unpacked 
fd is formatted in the 
standard unpacked fd format 
including a colon Ce7, 
period (.), and slash (/). 


UPFO.ADR The source address of the 


packed fd is specified by 
the UPFD.SAD field of the 
SVC 2 code 29 parameter 
block. The unpacked fd is 
to be stored in the address 
location specified by the 
UPFD.DAD field of the 
parameter block. 


NOTE 


If X'Ol1' is not specified, the source and 
destination addresses are to be found in 
the registers specified by the UPFD.SRC 
and UPFD.DST fields, respectively. 


Code 
(UPFD.COD) 


Source 
Register 
(UPFD.SRC) 


Destination 
Register 
(UPFD.DST) 
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is a 1l-byte field that contains the decimal 
number 29 indicating code 29 of SVC 2. 


is a l-byte field that specifies the number of 
the register that contains the address of the 
file directory entry or SVC 7 parameter block 
that contains the source of the packed fd. 


is a l-byte field that specifies the number of 
the register that contains the address of a 
24-byte buffer in a task writable segment 
where the unpacked fd is to be stored. 


NOTE 
If option xXx'Ol1' has been 
specified, the source register and 


destination register fields must 
be filled with zeros. 
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Source 
pointer for 
option X'0Q1' 
(UPFD.SAD) 


Destination 
pointer for 
option X'Ol' 
(UPFD.DAD) 


is a 4-byte field that contains the address of 
the file directory entry or SVC 7 parameter 
block that contains the source of the packed 
fd. This field is used only if option X'Ol' 
has been ci ca 

is a 4-byte field that specifies the address 
of a 24-byte buf fer in a task writable segment 
where the unpacked fd is to be stored. This 
field is used only if option xX'Ol1' has_ been 
specified. 


The following examples demonstrate the use of SVC 2 code 29. 


Example 1: 


SVC229 PROG SVC 2,29 EXAMPLE - UNPACK FD 
SVC 2,UFD UNPACK FD 
sVC 2, PAUSE 


ALIGN 4 
PAUSE DB 0,1,0,0 PAUSE 
UFD DB X'Al',29,0,0 NNN, FD, :./, SQUEZ, ADDR 
DAC SOURCE PACK FD INPUT 
DAC DEST UNPACK FD OUTPUT 
SOURCE DB C'TEST css',71 INPUT PACKED FD 
DEST DS 24 OUTPUT UNPACKED FD 
END 
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Example 2: 


SVC229A PROG 
NLSTM 
$SVC7 


LA 
LA 
SVC 
svc 


ALIGN 


PAUSE DB 
UFD DB 


DAC 


SVC7PBLK DS 


DEST DS 
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SVC 2,29 EXAMPLE - UNPACKED FD 


1,SVC7PBLK 
2,DEST 


SVC7. 


SVC7PBLK+tSVC7.VOL 


C'MTM ' 
C'TEST : 
c'css' 

C'G' 


24 


ADDRESS OF SOURCE 
ADDRESS OF DESTINATION 
UNPACK FD 


PAUSE 
PGS, SVC7, BILANKS, BLANKS, REG 


INPUT PACKED FD 


OUTPUT UNPACKED FD 
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CHAPTER 4 
END OF TASK SUPERVISOR CALL 3 (SVC 3) 


4.1 INTRODUCTION 


Svc 3 terminates task execution. 
the SVC 3 format. 
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This 


is 


accomplished through 


4.2 SVC 3: END OF TASK 


Format: 
SVC 3,n 
Fields: 

SVC is the mnemonic used aS an operation code 
indicating that it is a supervisor call. 

3 is a decimal number indicating it is SVC 3. 

n is a decimal number ranging from 0 through 255 
used as the end of task code when the task 
terminates. If this number is greater than 
255, it is truncated to eight bits. End of 
task codes greater than 255 are reserved for 
system use. The end of task code can be’ used 
in subsequent command substitution system 
(CSS) conditional testing. The following 
standard end of task codes are used: 

e O indicates normal termination. 

e 255 indicates termination caused by 
cancellation. 

e 1000 indicates termination caused by task 
queue overflow on expiration of time 
interval. 

e 1100 indicates mapping error in impure 
segment during rollin. 

e 1101 indicates mapping error in pure 
segment during rollin. 

e 1102 indicates pure segment was not found 
Quring rollin. 

e 1105 indicates I/O error on roll file for 
impure segment. 

e 1106 indicates [I/O error on roll file for 
pure segment. 
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e 1200 indicates termination caused by 
expiration of CPU time limit. 


e 1210 indicates termination caused by 
expiration of I/O transfer limit. 


In addition, the end of task code can be stored in a_ register. 
For example, to generate a code of 4, use the following sequence: 


LHI R8,4 
svc 3,0(R8) 


If I/O is in progress when an SVC 3 is executed, write operations 
continue until completed and then terminate normally; read 
operations terminate immediately. 


For all logical units, read operations and SVC 15 operations are 
halted via an SVC 1 halt I/O. If the task is resident, an SVC 7 
checkpoint is executed. If the task is nonresident, an SVC 7 
close is executed. 


For more information on using end of task codes in CSS, refer to 
the OS/32 Operator Reference Manual. 


48-038 FOO ROL 4-3 


CHAPTER 5 
FETCH OVERLAY SUPERVISOR CALL 5 (SVC 5) 


5.1 INTRODUCTION 


SVC 5 permits user-controlled loading of overlays generated by 
Link or TET. Loading of overlays is accomplished through the SVC 
5 parameter block in Figure 5-1. The SVC 5 parameter block is 12 
bytes long, fullword-boundary aligned, and must be ina task 


writable segment. 
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10(0) 
| 
i 
H haste es ls aie ots nie ts em 
14(4) 
H 
H 
H am saat cao ney cine iene tum tet soem OND Gm AED UMD GED mu mame 
i8(8) 
! Error status | 
H (SVC5.STA) | 
SVC 
ALIGN 
parblk DC 
DS 
DB 
DC 
Figure 5-1 
Fields: 


Overlay name 
(SVC5.ID) 


9(9) 


ee ee ee ee dd) 


Overlay name 
(SvC5. ID) sea ee eet 


| LO(A) lu 
Options H assigned to overlay file 
(SVC5.OPT) | (SVC5.LU) 


ee i a Be ee ee ee eed 


5,parblk 


4 

C'8 character overlay name' 
1 

‘option' 

H'lu' 


SVC 5 Parameter Block Format and Coding 


is an 8-byte field specifying the name of the 
overlay to be loaded. If the overlay name 
requires less than eight characters, the data 
in this field must be left-justified with 
trailing spaces. 
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Error status 
(SVC5.STA) 


Options 
(SVC5.OPT) 


Logical unit 
assigned to 
overlay file 
(SVC5.LU) 


48-038 FOO ROL 


For overlays generated by TET, the overlay 
name field is matched against the overlay name 
in the loader information block (LIB) of the 
overlay file. For overlays generated by Link, 
this field is matched against the overlay name 
in the overlay descriptor table (ODT) of the 


task image file. The ODT contains’ the 
information needed by Link to process’ the 
overlay. If the overlay name is found in the 


ODT, loading of the overlay proceeds as if an 
automatic overlay load occurred. 


is a l1-byte field that receives the 
appropriate error code when an error occurs 
during the execution of SVC 5. The status 
returned is one of the following: 


@ x'‘oo'! indicates overlay loaded 
successfully. 


e xX'10' indicates load failed. 
e xX'‘'20' indicates a mismatch on overlay name. 


e xX‘'40' indicates overlay would not fit in 
allocated memory. This error code applies 
to overlays generated by TET only. 


is a l-byte field that must contain one of the 
following options: 


@ Option X'O1' indicates load from logical 
unit (lu) without positioning. 


@ Option X'04' indicates load from lu after 
rewind. 


The option byte is not required for overlays 
generated by Link. 


is a 2-byte field containing the device to 
which the overlay file must be assigned and 
must be positioned to the first byte of the 
LIB for the overlay generated by TET. This 
field is not required for overlays generated 
by Link. 


The calling task is placed in a wait state until the overlay is 
loaded. If the overlay is successfully loaded, the calling 
program can branch and link to the overlay. 


Certain messages might be generated as a result of loading 
overlays created by Link. These messages are discussed in the. 
OS/32 Link Reference Manual. 


Example: 
svc 5,parblk 
ALIGN 4 
parblk DC C'MARIANNE ' 
DB 0 Initialize status to 0 
DB Ll Load without print 
DC Ht 2! Overlay assigned to lu 2 
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CHAPTER 6 
INTERTASK COMMUNICATIONS SUPERVISOR CALL 6 (SVC 6) 


6.1 INTRODUCTION 


SVC 6 provides a task with the ability to communicate with and 
control another task. The task that issues an SVC 6 is known as 
the calling task. An SVC 6 can be directed to any task within 
the calling task's execution environment, including the calling 
task itself. The task to which the SVC 6 is directed is called 
the directed task. 


Before a calling task can issue an SVC 6, that task must be 
linked with one of the following task options: 


e COMMUNICATE - this option allows a calling task to perform 
SVC 6 intertask communication functions. See Section 6.2.1. 


e@ CONTROL - this option allows a calling task to perform SVC 6 
intertask control functions. See Section 6.2.1. 


In an OS/32 real-time environment, only foreground tasks can 
issue an SVC 6. If a background (BG) task attempts to issue this 
call, the OS will treat the call as an illegal call or NOP, 
depending on the SVCPAUSE task option in effect. See the 0S/32 
Link Reference manual for more information on the task options 
that apply to SVC 6. 


NOTE 
SVC 6 cannot be executed in a 
multi-terminal monitor (MTM) environment 


unless specified as an MTM option at 
system generation (sysgen). 
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= oe ——_ ae ww eee eee ee ee 


— eee eee 


i SVC 6 


6.2 SVC 6: INTERTASK COMMUNICATIONS 


Communication and control between tasks are accomplished through 


the SVC 


6 parameter block shown in Figure 6-1. 


10(0) 
{ 
{ Name of task 
[SSssaseees-se receiving SVC 6 = = 7-7-7 rr rr errr 
14(4) (SVC6. ID) 
t 
H —e eee eee eee eee eee eee wee ee oe wee ee ew we ew ewe wee eee ee we ew www HK 
18(8) 
{ Function code 
{ (SVC6 .FUN) 
{12(C) 114(E) 
{ Wait status H Error status 
{ (SVC6.TST) t (SVC6.STA) 
| ------------~----------------+----+ +--+ + 0-2 ee nee 
$16(10) lu 117(11) Change {18(12) Current;19(13) Assign 
i to load task | priority H priority i Logical Pro- 
{ (SVC6.LU) | (SVC6.PRI) {| (SVC6.RPI) j cessing Unit 
i | I i (LPU) 
i i i i (SVC6.LPU) 
eaten en onea Sse een e ss else ese se sees eel se eee eee eae scte 
120(14) 
{ Starting address of directed task 
H (SVC6.SAD) 
{24(18) Imcre- [{25(19) 
+ ment of time | Count 
1 (SVC6.TIM) | (SVC6.CNT) 
H ee ee et 
128(1C) Address of load image fd or 
I device mnemonic 
{ (SVC6.DMN) 
{ eee we a a a a an ne a a ee ew ee a a a a ee eee ewww 
132(20) 133(21) 
! Reserved H Task queue parameter 
| i (SVC6.PAR) 
{ a a a a a a a a a a a a a a ns a a a a a a a a a a a ee ee we ww a ww = = 
136(24) 
| Address of message buffer or address of start options 
| (SVC6 .MSG) (SVC6 .SOP) 
{ ee ee ee es 
140(28) 
H Segment size increment 
! (SVC6 .SEG) 
{ wee ww ww nw a ow oe an a a a ee ee we eee eee ee ee 
144(2C) 145(2D) 146(2E) 
| Calling lu ; Directed lu |} Extended load options 
{ (SVC6.CLU) { (SVC6.DLU) } (SVC6.ELO) 
sve 6,parblk 
ALIGN 4 
parblk Dc C'8-byte name of task receiving SVC 6‘ 
Dc Y'function code’ 
DS 2 bytes for wait status 
DS 2 bytes for error status 
DB 1 byte for lu to load task 
DB 1 byte for change priority 
DS 1 byte for current priority 
DB l byte for logical processing unit 
DC A(start) 
bc Y'increment of timetcount' 
DC C'4-byte device mnemonic' or A(fd) 
pc Y'task queue parameter' 
Dc A(message buffer or start options) 
DC Y'segment size increment’ 
DB 1 byte for calling lu number 
DB 1 byte for directed lu number 
DS 2 bytes for extended load options 


Figure 6-1 SVC 6 Parameter Block Format and Coding 
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This parameter block must be 48 bytes long, fullword-boundary 
aligned, and located in a task writable segment. For a detailed 
description of the functions of each field in the parameter 
block, refer to the appropriate section in this chapter. A brief 
description of each field in the parameter block follows. 


Fields: 


Name of task 
receiving 
SVC 6 
(SVC6.ID) 


Function 
code 
(SVC6 .FUN) 


Wait status 
(SVC6.TST) 


Error status 
(SVC6.STA) 


lu to load 
task 
(SVC6.LU) 


Change 
priority 
(SVC6.PRI ) 


Current 
priority 
(SVC6.RPI) 
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is an 8-byte field that contains the task 
name to which SVC 6 is directed. If SVC 6 is 
a self-directed call, this field is not 
required. The name must consist of one to 
eight alphanumeric characters with the first 
character always alphabetic. It is 
left-justified in the field with spaces. 

is a 4-byte field that contains the 
hexadecimal number indicating the function to 
be performed. 


is a 2-byte field that receives the 
hexadecimal value of bits 16 through 31 of the 
directed task's wait status fullword when a 
SVC 6 is executed. If the calling task wants 
to check the wait status of the directed task 
at any time, an SVC 6 can be issued with bits 
O and 1 of the function code set to 10 or 11 
and the remaining bits set to 0. 


is a 2-byte field that receives the 
appropriate error code when an error occurs 
during execution of the SVC 6. If no error 


occurs, a value of O is stored in this field. 


is a l-byte field used only when a_ load 
operation is requested. This field must 
contain the user-specified hexadecimal number 
indicating the logical unit currently assigned 


to the directed task that is to be loaded. 


is a 1l-byte field used only when a change 
priority operation is requested. This field 
must contain a user-specified hexadecimal 
number indicating the new priority to which 
the task is to be changed. The hexadecimal 
number must have a decimal value ranging from 
10 through 249. 


is a l-byte priority field that receives a 
hexadecimal number indicating the priority 
at which the task is executing when an SVC 6 
is executed. If the calling task wants to 
check the current priority of the directed 
task at any time, an SVC 6 can be issued with 
bits 0 and 1 of the function code set to 10 or 
ll and the remaining bits set to O. 


(on) 
I 
Ww 


—_ am we ee 


ae ae we eee we ee 


Assign 
logical 
processing 
unit (LPU) 
(SVC6.LPU) 


Starting 
address of 
directed 
task 
(SVC6.SAD) 


Increment of 
time 
(SVC6.TIM) 


Count 
(SVC6.CNT) 


Address of 
load image fd 
or 


device 
mnemonic 
(SVC6 .DMN) 


Reserved 


Task queue 
parameter 
(SVC6 . PAR) 


is a l-byte field used only when an LPU 
assignment operation is requested. It con- 
tains a user specified hexadecimal number 
indicating the LPU assigned to the task 
(O...max LPU). 


is a 4-byte field used only when a start 
operation is requested. This field must’ con- 
tain a user-specified hexadecimal number 
indicating the address where the directed 
task is to start execution. 


is a l-byte field used in conjunction with the 
count field only when the delay-start 
operation is requested. This field must 
contain a user-specified hexadecimal number 
indicating how the time is to be calculated. 
These hexadecimal numbers are: 


e Option x'OO' indicates seconds from 
midnight (time of day). 


@e Option X'10' indicates milliseconds from 
the time this call is executed (interval 
timing). 


is a 3-byte field used in conjunction with the 
increment time field only when ae edelay-start 
operation is requested. This field must 
contain a user-specified decimal number 
indicating how many seconds or milliseconds 
must elapse before the directed task starts 
execution. 


is a 4-byte field that contains a user- 
specified device mnemonic of a trap generating 
device when the connect, thaw, sint, freeze, 
or 

unconnect operations are requested. If a 
task is to be loaded with bit 3 (load and 
proceed) of the extended load option field 
set, this field should contain the address of 
the fd of the file containing the task to be 
loaded. 


is a reserved l-byte field that must contain 
a 0. 


is a 3-byte field used only when the add to 
task queue or connect to trap generating 
device operations are requested. This field 
must contain the user-specified parameter that 
is to be added to the task queue of the 
directed task. 
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Address of 
message 
buffer 

(SVC6 .MSG) 

or 

address of 
start options 
(SVC6.SOP) 


Segment size 
increment 
(SVC6 .SEG) 


Calling lu 
(SVCb6.CLU) 


Directed lu 
(SVC6 .DLU) 


Extended 
load options 
(SVC6.ELO) 


is a 4-byte field used 
message operation or. start operation is 
requested. For the send message operation, 
this field must contain a_ user-specified 
hexadecimal nmumber indicating the address of 
the buffer containing the message to be sent 
to the directed task. For the start operation, 
this field must contain the address of the 
start options to be included at run time. 


only when a_=e send 


is a 4-byte field used only when 
operation is requested and must 
user-specified hexadecimal number indicating 
the number of bytes used to expand the task's 
allocated memory. 


a load 
contain the 


is a 1l-byte field that must contain the 
user-specified hexadecimal number representing 
the logical unit of the calling task. 


is a 1-byte field that must contain the 
user-specified hexadecimal number representing 
the logical unit of the directed task. 


is a 2-byte field used only when the extended 
load options are requested. This field must 
contain a user-specified hexadecimal number 
indicating one or more options listed in Table 
6=3'. 


6.2.1 Function Code (SVC6.FUN) 


SVC6.FUN has 21 


functions 


for 


intertask 


communication 


and 
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control. These functions are listed in Table 6-1. 
TABLE 6-1 SVC6.FUN FUNCTIONS 
| COMMUN I CATION i { 
| FUNCTIONS | CONTROL FUNCTIONS { 
H Sse SESS2 S22E SE SSB Ss SSS2 SSI SS VSSSESA SHE RRR BABAABRBESBASABTA ESS SIS SSS SS = i 
i Send data i Direction | Freeze ‘ 
| Send message | End task | Unconnect H 
| Add to task queue ; Load task | Assign LPU H 
H ij Resident task ; Transfer to LPU } 
i i Suspend i Transfer to CPU } 
i | Change priority {| Release H 
H } Send lu ; Nonresident H 
i i Receive lu { Rollable { 
| ;} Connect | Nonrollable : 
i i Thaw ; Start : 
H i} Sint i 


am wee we 


These functions are specified by setting the appropriate bits in 
the function code field shown in Figure 6-2. Each bit setting 
and its corresponding function are listed in Table 6-2. 


Reserved 


0 £2 3.4 5 6 7 8 9 10 11 12 13 14 #15 


a a See Se ee ee Se ee eS SD Oe ee a ey ee ee oe cee ee ee oe ee Ge EE Oe te ee ee ee ee eee es oe ee SEN et mee en SE mee Sey Mme GY meme OO eee SH 


6 17 18 19 20 21 22 23 24 25 26 27 28 29 31 


Figure 6-2 SVC 6 Function Code Field 


TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC 6 CALLS 


i BIT } FUNCTIONS AND | H \ 
i POSITIONS }| MASK NAMES H MEAN ING { BIT SETTINGS i 
i O (D) | Direction { The task to {| 0O = illegal H 
H 1 i (SFUN.DOM=10) |} which SVC 6 ; O1 = illegal i 
i i (SFUN.DSM=11) {| is directed. } 10 = other task H 
i H \ ; ll = self direc- H 
i ted 
sass ems “ll ls ic Sat“ ei, Wah. ak inks mat Wl gs "Sc gs es st ce, Ge i ee es ae ag a i a a a ete Wines SmI i ss ald WAL ed Salas Mae Lee Si t 
2 (EB) End task End or term- 00 = no function 
3 (SFUN .ECM=01) inate task requested 


i 
i i i H 
i (SFUN.EDM=10 | execution. ; O1 = cancel H 
; or =11) H ; 1O = delete dir- jj; 
i H H ected task | 
i H | 11 = delete dir- |} 
4 ) { ' 
' { t ! 


ected task 


ee ee ee ees we ee we we 
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TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC 6 CALLS 


( 


Continued) 


ae cee em et Gee em See CED me me re rm re mm mm SR a ne me cy mee See me OE Ge eee ey SS ee SS neem me eee ee SD OS Meee A ED em mie eS ce ee Me RS RO oe ae Sy Ye ee Te GO ne me Ae 


H BIT 1} FUNCTIONS AND 
| POSITIONS ; MASK NAMES 
{ 
i] 
4 i N/A 
5 
t 
i 6 (L) | Load task 
H 7 (C) | (SFUN.LM=10 
H ;}| SFUN.LXM=01) 
' { 
1 t 
| | 
{ ( 
( 1 
i 
i 
i 
8 (H) Resident task 
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(SFUN.HM) 


Suspend 
(SFUN .SM) 


Send data 
(SFUN. DM) 


(SFUN .MM) 


Change 
priority 
(SFUN. PM) 


-MEAN ING 


Reserved 


Load directed 
task. 


Make directed 
task resident 
in memory. 


Put directed 
task into a 
wait state. 


The calling 
task sends a 
variable 
length mes- 
sage to di- 


rected task. 


The calling 

task sends a 
64-byte mes- 
sage the di- 
rected task. 


Add parameter 
to directed 
task queue. 


Change 
priority of 
directed 
task. 


00 


BIT SETTINGS 


SSS SS SSDS RSS SSSR SSSESS SSBB SSS SS SMI SBSBBSSSSSSESRESEAESBsI AS SSS SSB SSS Ss 


reserved 


no function 
requested 
illegal 
load task 
load task 
(10) with 
extended 
load option 
(01) 


no function 
requested 
make task 
resident 


On eens se Se SD GD Se eee See oe GD SE ES SEP GR eee See A a eee ee Ge Gee eee A ee ae Ge ee ee ee ee ee ee cee ewe eee ee ee ee ee ee ee ee ee 


no function 
requested 
put task 
into wait 
state 


oe we arms Se ee tem mee eee ee cm a ee em eee nme ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 


no function 
requested 
send messag 


no function 
requested 
send messag 


no function 
requested 
add to task 


Pe a GED NED AD WUE me MD GEE A eS SP SD Oe) SE SD SES GES eee Me ES GE SR SE EE Se OR OE EN Ieee SE Oe LES SED ORS SED SOE SE Cee Se SD Se em ee ee Ge ow cee Eee com Ome Se Se mee ee fee HO ee Oo 


no function 
requested 
change the 
priority 


——e ee ee we 


-—~< 


Ss 


ee ee a 


e 


e 


ee ee we ee ee we ee we ee 


_—— we we we wow 


TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC 6 CALLS 


(Cont inued ) 


we ee ee ee eee ee ee we ee ee ee 


14 


15 


BIT 


POSITIONS 


(B) 


(V) 


FUNCTIONS AND ; 
MASK NAMES i 


Send lu ' 
(SFUN. XSM=10) 


i] 
H 
i 
H 
Receive lu i 
(SFUN.XRM=01) } 
{ 
i} 
i 
i 


Connect 
(SFUN.OM) 


Sint 
(SFUN. IM) 


Freeze 
(SFUN.FM) 


Unconnect 
(SFUN.UM) 


Assign LPU H 
(SFUN.LPM) 
f 
' 


MEAN ING H 


Calling task's} 
lu is assigned} 
to the { 
directed task. ; 
Directed H 
task's lu is | 
assigned H 
to calling H 
task. H 


A trap gener- ; 
ating device jj; 
is connected j; 
to directed H 
task. i 


Enable inter- | 
rupts on trap } 
generating H 
device H 
connected to jj} 
directed i 
task. 


Simulate 
interrupt on ; 
trap genera- | 
ting device H 
to directed H 
task. 


Disable inter-} 
rupts on trap } 
generating H 
device H 
connected to jj; 
directed task. } 


Disconnect i 
specified trap} 
generating i 
device from H 
directed task. } 


Assign LPU to ; 
directed task } 
i 


00 
10 


Ol 
11 


BIT SETTINGS 


= no function 
requested 
= gend lu 


= receive lu 
= illegal 


= no function | 
requested i 

= connect i 
device to H 
task i 

i] 


= no function |} 
requested j 

= enable inter-} 
rupts H 
H 

i 

H 

i 


—— sem ce aw eee ae ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee ee ee eee ee ee ee Oe ee ee ee ee ee ee ee ee 


= no function ; 

requested j 
= simulate H 
interrupt } 


eRe ee Se ae ne ee ee ee ee co ee ee ee ee ee ee ee ee ee ce ee ee ee ee ee ee ee ee ee, ee le ee eo ee ees ee ee es 


= no function |; 
requested H 

= disable 
interrupts H 
! 


— ee eee He ee Re oes me ee See a ee ee ES SO eS eS me ee Se eee ee Oe ee ee ee ee aS em ee le ee 


= no function i 
requested i 

= disconnect j 
device from | 
task i 

{ 


= no function H 
requested 1 
= assign LPU H 
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TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC 6 CALLS 
(Cont inued) 


BIT FUNCTIONS AND 
POSITIONS MASK NAMES MEAN ING BIT SETTINGS 


+ O = no function 
i; 1 = set LPU- 

i; directed status 
; in TCB 


LPU PU-directed 


i H 
) i] 
' { 
22 (TL) | Transfer to | Make task 
i. io 
; (SFUN.XLM) H 
' t 
( ' 


i 23 (TC) | Transfer to |} Make task {| O = no function 
1 | CPU | CPU-directed } requested 
i {| (SFUN. XCM) H { 1 = reset LPU- 
i ! ' { directed 
i i i H status in TCB 
| Sa na eee eee eee eee ae eee 
i; 24 (R) i Release i Remove : O = no function 
H } (SFUON.RM) } directed task |} requested 
H H i from wait { Ll = remove task 
{ H ; state. H from state 
jprcccec cs i “ab sss“ Sch saves eh ceo el (Diesels, aes ci sm ssn ak ime clan Se i mae bam Sw in amis 
; 25 (N) i Nonresident | Make directed } O = no function 
H i} (SFUN.NM) | task nonresi- j; requested 
H i ; dent. ; Ll = make task 
H H | \ nonresident 
H fe es esi cay aS Snel Soh wn” mss aes sees eu ee tes eu arpa” Sn igs og cm ps fas a a es a a eh a ca ce A a a 
| 26 (Y) i Rollable | Make directed } O = no function 
i (SFUN.RLM) | task rollable. } requested 
i 1 H ; Lt = make task 
H H i i rollable 
| a a ag a Poe SR Pe aE Ae eee ee ee ee a ee 
1 27 (2) | Nonrollable | Make directed } O = no function 
i | (SFUN.NRM) {} task nonroll- ; requested 
| i ;} able. i Ll = make task 
H i i H nonrollable 
H sw ni “case gp ens sh “esata <snip> SSeS Sami (is? es rm i cei ws cms 
i 28 i N/A ; Reserved |; O = reserved 
| ci ec me ec ea ls sans scien emu a Sk ha et ss som a Fe ew 
29 Start Start O00 = no function 
30 (A) (SFUN.SIM=010){ execution of requested 
31 (SFUN.SOM=011); directed 001 = illegal 
(SFUN.SDM=100)} task. 010 = start 
or =110) O11 = start with 
start 


100 = delay start 

101 = delay start 
with start 
option 

110 = delay start 


i 
H 
H 
1 
H 
{ 
H option 
1 
H 
i 
1 
H 
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6.2.2 Direction (SFUN.DOM,SFUN.DSM) 


The direction function identifies the task to be affected by the 
Svc 6 call. The name of this task is located in the task name 
field. The required parameter block fields for this function 
are: 


e@ Task name field 


@ Bits O and 1 of the function code field 


If the bit setting equals 10 (SFUN.DOM), the call is directed to 
any system task whose name must be specified in the task name 
field. If the bit setting equals 11 (SFUN.DSM), the call is 
self-directed or directed to the task initiating the call. A 
self-directed call does not require a name in the task name 
field. A call can also be self-directed by setting the bits to 
10 and specifying the calling task name in the task name field of 
the parameter block. Other bit settings for bit positions O and 
l are illegal and cause an error code to be stored into the error 
status field of the parameter block. 


6.2.3 End Task (SFUN.ECM,SFUN.EDM) 

The end task function abnormally terminates or cancels execution 
of the directed task. The required parameter block fields are 
the task name field and bit positions 0, 1, 2, and 3 of the 
function code field. When the bit setting equals 01 (SFUN.ECM) 
and the directed task is resident, these operations occur: 

e Task execution is cancelled. 

e The task remains in memory. 

e All the task's assigned files and devices are checkpointed, 


not closed. 


When the bit setting equals O1 (SFUN.ECM) and the directed task 
is nonresident, these operations occur: 


e Task execution is cancelled. 
e The task is removed from memory. 


e All the task's assigned files and devices are closed. 
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When the bit setting equals 10 or 11 (SFUN.EDM) and the directed 
task is resident, these operations occur: 

® Task execution is cancelled. 

@ The task is made nonresident. 

® The task is removed from memory. 

® All the task's assigned files and devices are closed. 

When the bit setting equals 10 or 11 (SFUN.EDM) and the directed 
task is nonresident, these operations occur: 

® Task execution is cancelled. 

® The task is removed from memory. 

® All the task's assigned files and devices are closed. 

If this call is self-directed, SVC 6 is immediately terminated. 
After the call is executed, an end of task code 255 indicating 
abnormal termination is returned to the user. 

6.2.4 Load Task Functions 

The load task function loads the directed task into memory. 
Options are provided for the calling task to wait until the load 
is completed or to continue execution and receive a trap when the 
load is completed. 

When a task is loaded, the operating system reads the _ loader 
information block (LIB) of the task to see if any needed shared 
segments are already in memory. If they are not in memory, the 
auto-loader feature automatically loads them, provided sufficient 
memory exists. See the OS/32 Operator Reference Manual. When 
all shared segments named in the LIB are memory resident, the 
operating system builds linkages to them. 

6.2.4.1 Load Task (SFUN.LM) 

The required parameter block fields for bit setting 10 (SFUN.LM) 
are: 

e Task name field 


e Bits O, 1, 6, and 7 of the function code field 


e lu to load task field 
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Before executing this call, the lu specified in the parameter 
block must be assigned to the file or device containing the 
directed task image file. This call is processed as a load wait. 


The lu must be positioned to the first byte of the task LIB. 
When this call is executed, the directed task is loaded from the 
specified lu into a memory area large enough to hold the _ task. 
If such an area does not exist and the roll option is specified, 
the directed task is rolled out to a file on the roll volume and 
placed in a wait state. While the directed task is being loaded, 
the calling task is placed in a wait state. When the directed 
task is loaded, its task name becomes the name specified in the 
task name field of the parameter block. The calling task is 
released from the wait state, and the lu is positioned to the 
byte following the loaded task. If the same task is to be 
reloaded from other than a direct access device with the same lu 
assigned, the lu must’ be rewound by using SVC 1 prior to each 
subsequent load. For direct access devices the load task 
function intitializes the start address to zero. 


If the following error conditions occur, SVC 6 is rejected, and 
an error code is’ stored in the error status field of the 
parameter block: 

e The receiving task is already loaded into memory. 

e The task name specified in the parameter block is invalid. 


e The call is self-directed. 


e The system does not have a memory area large enough to hold 
the receiving task and does not support the roll option. 


e The requested memory size specified in the segment size 
increment field is larger than the total system memory space. 


e The directed task is a background task. (Background tasks can 
be loaded only from the system console.) 


e The lu is not positioned to the LIB or the LIB is invalid. 


6.2.4.2 Load Task with Extended Load Options (SFUN.LXM) 
The extended load options can be specified at load time and are 


located in the extended load options field of the parameter 
block. See Figure 6-3. 
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Reserved 


1CM {RP {SZ {PR {ET {CT } 


0 1 2 3 4 5 6 7 8 15 


Figure 6-3 Extended Load Options Field 


The required parameter block fields for bit setting 7 (SFUN.LXM) 
are: 


e Task name 
e Bits O, 1, 6, and 7 of the function code field 


e ilu to load task field (required when the load wait extended 
option is specified) 


@e Address of load image fd or device mnemonic field (required 
when load and proceed extended option is specified) 


@ Extended load options field 


e Segment size increment field. This field is required only 
when the task to be loaded needs a memory area larger than the 
task image size. The extended load option SELO.SZM must be 
set. 


When a task is loaded with the SFUN.LXM enabled, any options 
specified in the extended load options field are in effect during 
execution of the directed task. See Table 6-3 for a list of the 
available options. 


When the extended load and proceed option is requested, the 
calling task continues executing while the directed task is 
loaded. The directed task is loaded from the file indirectly 
specified by the device mnemonic field in the SVC 6 parameter 
block. This field should contain the address of the fd of the 
task image file to be loaded. If the roll option had been 
specified when the directed task was link-edited, the private 
image segment of the task is rolled out to disk if sufficient 
memory space is not available. 


48-038 FOO RO1 6-13 


When bit 3 (load and proceed) of the extended load options field 
is not set, execution of the calling task is suspended during 
loading of the directed task. This is called a load wait 
operation. After a load wait operation is completed, the calling 
task is released from suspension and the lu assigned to the 
directed task image file is positioned at the byte following the 
last byte of the task image. If the task is again loaded from 
the same lu, an SVC 1 rewind operation should be performed on the 
task image file prior to that load. 


TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 


BIT { OPTION AND i 
POSITION |} MASK NAME H MEAN ING 
0 (CM) Intertask i If bit 0 equals 1, the directed 
communication task that was loaded into memory 
(SELO .CMM) can execute the SVC 6 communica- 
tion functions. 


receiving task issues an SVC 6 

communication function, the call 
is rejected, and an error code is 
stored in the error status field 


t 
i 
i 
{| If bit O equals O and the loaded 
! 
: 
i 
i 
| Of the parameter block. 


wom wee ee ee ee ee ee ee ww we ee we 


If bit 1 equals 1, the calling 
task becomes a monitor task and 
the directed task becomes a sub- 
task. This causes the subtask to 
report all status changes during 


Subtask | 
H 
| 
\ 
| 
i; execution to monitor the task 
j 
i 
H 
H 


reporting 
(SELO.RPM) 


through task traps. 


If bit 1 equals O, the directed 
task is not a subtask. No subtask 
status changes are reported. 


Segment size 
Increment 
(SELO.SZM) 


| If bit 2 equals 1, the size of the 
| task workspace is increased by 

| adding a user-specified number of 

| bytes. This hexadecimal number 

i must be located in the parameter 

| block segment size increment field. 
‘ 
: 
\ 
H 


If bit 2 equals 0, the workspace 
set by the WORK= parameter of the 
LINK OPTION command is used. 
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TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 
(Continued ) 


ee ee cee A Se ee se ee ee ee ee ee ee ee ee ee cee ee ee @ ore ee ee ee ee ee en ee ee ee ee ee ee ee 


BIT |} OPTION AND 
POSITION | MASK NAME 
3 (PR) i Load and 

proceed 
(SELO.PRM) 


! 
! 
H MEAN ING 
i If bit 3 equals 1, the calling 
;| task continues executing while 
;} the directed task is being loaded 
| from the file specified by the 
; device mnemonic field of the SVC 6 
} Parameter block. A trap to the 

i calling task occurs if bit 20 of 

| its task status word (TSW) equals 
{ 1 (load and proceed comlete). When 
i the trap occurs, the reason code 

i X'7' and the SVC 6 parameter block 
| address are added to the task 

} queue. * 

i 

i 

i 

i 

i 


If bit 3=0, the calling task is 
suspended while the directed task 
is loaded from the specified lu. 
This lu must be assigned to the 
file or device from which the task 
is to be loaded. 

Prevent | If bit 4 equals 1, any directed 
e-task or | task that is an e-task or d-task 
d-task | is not loaded. If the calling 
(SELO .ETM) i} task issues an SVC 6 call to load 
} an e-task or d-task with this bit 
i; set, the call is rejected, and an 
} error code is stored in the para- 
i] 

! 
H 

H 

H 

i 

H 


—_ ee ae oe ew we we we wwe ee we we we Ow we we we we wee = 


a see Ee ee ee eee ee ee ee ee cme cee eee ee ee ee eee 


meter block error status field. 
If the loading task has bit 4 set 
and the directed task was linked 
with ACPRIVILEGE, DISC, or the 
INTERCEPT task option, the task 
will be loaded but these options 
will be disregarded. 

Intertask If bit 5 equals 1, the directed 
control task that was loaded into memory 
(SELO.CTM) can execute the control functions 
of SVC 6. 


—e eee sees eee ew ae ee ee ee ee we ewe ee oe 
mm ae eee ee eee eee ee ee ee eee ee eee 


If bit 5 equals O and the directed 
task that was loaded issues an SVC 
6 control function, the call is 
rejected, and an error code is 
stored into the error status field 
of the parameter block.** 


wee ee eee we we we we eww we woe woe 
ae we we ww ew we we we we we we 
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TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 


(Cont inued) 
' BIT ' OPTION AND } 
} POSITION {| MASK NAME H MEAN ING H 
| =S=sS SSS SS SS SSS SSS SS SS LS SS SS SS SS SSS SSS SS SSS SSS SSS SSS SSS ST SS SS TT i 
i 6 (RL) } Roll i If bit 6 equals 1, the directed { 
H i (SELO.RLM) i task is forced to be a rollable H 
H { } task regardless of the roll option |} 
H { ; established by Link. H 
H H | If bit 6 equals O, the directed H 
H { } task uses the roll option estab- i 
{| lished by Link. i 
Se Se a a Se eee See ae SS Se Se Rene ae ee eee eee ee 
7 (AC) Accounting If bit 7 equals 1, the directed 
(SELO . AEM) task that was loaded into memory 


' 
} 
i is given the accounting option. 
i This setting will override the 
{| NOACCOUNT option established by 
} Link. 


If bit 7 equals O, the directed 
task uses the accounting option 
established by Link. 


= a eee ee we ae ee aee awe ee 
——_ ee ee ee ee ee oe 


* When bit 3 equals 1, all other SVC 6 functions are _ ignored 
except the start function and send start options. If the 
calling task terminates while the directed task is being 
loaded, the load continues, no trap occurs, and no status is 
stored in the parameter block error status field. 


*x Self-directed trap generating device (TGD) functions can be 
executed if bit 5 equals l. 


6.2.5 Task Resident (SFUN.HM) 

The task resident function makes the directed task memory 
resident regardless of what options were specified by Link. At 
end of task, the open logical units of a resident task are 
checkpointed and the task remains in memory. A resident task can 
be rollable. The required parameter block fields are: 

e Task name field 


e Bits O, 1, and 8 of the function code field 
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6.2.6 Suspend (SFUN.SM) 


The suspend function places the directed task into a wait state. 
The required parameter block fields are: 


e Task name receiving SVC 6 field 


® Bits O, 1, and 9 of the function code 


The directed task remains in the wait state until an SVC 6 
releasing the suspended task (bit 24 of the function code) is 
executed. If this call is self-directed, it causes the calling 
task to suspend itself. To release the calling task from the 
wait state, another task must be available to subsequently 
release it. 


This function can be used to suspend execution of APU active or 
ready tasks. See the 0S/32 System Level Programmer Reference 
Manual for more information on using SVC 6. in a Model 3200MPS 
multiprocessing system. 


6.2.7 Send Data (SFUN.DB) 


Blocks of data that are communicated from one task to another are 
called messages. The send data function allows a task to send 
variable length messages to another task. 


6.2.7.1 Send Data Message Buffers for Sending Task 


To pass a message from one task to another via the send data 
function, certain data structures are required. The most 
important of these structures is the send data message buffer. 
The structure of this message buffer allows the directed task to 
receive a variable length message in the format in which it was 
sent. The maximum length of a message that can be sent is 
determined by the size and number of the message buffers set up 
by the directed task to receive the message. However, the actual 
length of the message is determined by the number and size of 
message buffers set up by the task issuing the SVC 6. 


Hence, two data structures are required by the calling task, the 
SVC 6 parameter block and the send data message buffer. The 
required SVC 6 parameter block fields for this function are: 

e Task name field 

e Bit 10 of the function code field 

@ Address of the buffer containing the message to be sent (if a 


chain of buffers is to be sent, only the address of the first 
buffer in the chain is required. ) 
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The format of the send data buffer for the calling task is shown 
in Figure 6-4. 


10(00) {1(01) 

i Function Code | Buffer Link Address 

| (SBF .FC) H SBF .NXT | Header 

Soe ae Sr eae ee ee See eS ee aa ee i 

14(04) | 6(06) 

H Reserved i Message Field Length j| 

H (SBF .MLEN) H (SBF . LEN) H 

[Sao eS SS aS en ee ee a ae ae ae ae i 

{8(08) Reserved (lst Buffer Only) { 

Or 

i Beginning of Message H 

H (SBF . DATA) H 

ah eh ihe Semh uyh Sc“ Sie aS ena Sash Ser emt: Smee eh ls: mn: ei Sm Gm ‘ih emi sump Get esi Nm ‘ol eer il om lr i 

}16(10) Reserved for Sending Task Name | 

H (lst Buffer Only) i Body 

or | of 

i Continuation of Message i Message 

A a arm a a a adi a ome i 

[24(18) 

i i 

dL A 
Message 


Figure 6-4 Send Data Message Buffer Format for Calling Task 


Each send data message buffer can be variable in length provided 
that the buffer is aligned on a fullword boundary and its’ total 
length is equal to an integer number of fullwords. Note that the 
message buffer consists of two parts: the header and the body of 
the message. The message body holds the data that is to be sent. 
Because the send data function allows the size of a message to be 
variable, the length of the body is determined only by the 
quantity of data that is to be sent by SVC 6. 
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Note that if the buffer is the only buffer containing the message 
to be sent (or the first buffer ina chain), the first 16 bytes 
of the message body are reserved and filled with zeros. When the 
message is transferred to the directed task buffer, the first 8 
bytes of the message body of the directed task buffer are filled 
with zeros, the next 8 bytes are filled with the sending task's 
name (left-justified and padded with blanks). All remaining 
buffers in the chain use these first 16 bytes of the message body 
to hold data. 


A description of the fields in the message header follows: 


Function code is a l-byte field indicating whether’ the 

(SBF .FC) buffer is the only buffer to be sent, or is a 
member of a message buffer chain. The 
function codes are: 


e xX‘OO' - indicates that the buffer is an 
intermediate buffer in a chain. 
e xX‘'10' - indicates that the buffer is the 
last buffer in a chain. 
e X'‘'20' - indicates that the buffer is the 
first buffer in a chain. 
e@ xX'‘'30' - indicates that the buffer is the 
only buffer to be sent. 
Buffer link is a 3-byte buffer indicating the address of 
address the next buffer in the chain. The OS ignores 
(SBF .NXT) this field in buffers with a function code of 
X'10 or X‘'30". 
RESERVED is a 2-byte field reserved for use by the 
(SBF .MLEN) directed task. 
Message field is a 2-byte field indicating the length of the 
length -. message body for that buffer. 
(SBF .LEN) 


6.2.7.2 Free Send Data Message Buffers for Receiving Task 

Before a directed task can receive a message, the following 
structures must be contained within the task address space: 

e Free send data message buffers 

@ Free buffer list queue 


e Task queue 
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e UDL containing the address of the task queue, free buffer list 
queue, and TSW with address of send data trap service routine 


e TSW initialized to enable send data traps 
The total length of the free send data message buffers should be 
sufficient to hold the entire message transferred to those 


buffers by the calling task. The format of the free send data 
message buffers is shown in Figure 6-5. 


10(00) }1(01) 
Reserved Reserved 
| (SBF .FC) H (SBF .NXT) | Header 
Maks cise ees thf Al Scat Sai St gms pi ew Sie Se ip Sel: Saeki Secale “ee i ues us se ems sl soe ie ps Spa | 
14(04) i; 6(06) 
Maximum Message Length | Reserved 
H (SBF . MLEN ) H (SBF . LEN) H 
(ee seas Gn oe a ce ais rn anoint a eee | 
18(08) Reserved (lst Buffer Only) i 
or 
i Beginning of Message i 
H (SBF .DATA) H 
sla aa a atc a a ad 
116(10) Sending Task Name i 
H (lst Buffer Only) | Body 
Or | of 
H Continuation of Message | Message 
aaa aa a a aa a 
124(18) H 
AL -L 
Message 
9 a 


Figure 6-5 Send Data Message Buffer Format for Directed Task 


Like the calling task's message buffers, each free message buffer 
can be variable in length as long as the buffer is aligned ona 
fullword boundary and the total length in bytes is an even 
number. 


When initialized, the maximum message length field contains’ the 


number of bytes that are available for the body of the message. 
The remaining fields of the message header are reserved. 
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The address of each of the free message buffers is placed on a 
standard Perkin-Elmer circular list established in the task 
address space. This list is known as the free buffer list queue. 
The address of the queue is placed in the UDL.SDQ field of the 
UDL. 


When a calling task issues an SVC 6 to send a message, the OS 
takes the address of the free buffer list queue from the UDL and 
then takes a free buffer address off the queue. Once the _ free 
buffer is found, the OS sets the reserved field of the message 
body to blanks and enters the name of the calling task in the 
sending task name field (left-justified and padded with blanks). 
After the buffer is filled with the data from the calling task's 
message buffer, the OS places the number of bytes of the message 
body (including the reserved and sending task name fields) into 
SBF .LEN. 


If the entire message has not been transferred, the OS’ fetches 
the address of another free message buffer, places the address of 
this buffer in the SBF.NXT field and sets the function code. It 
then begins transferring message data to the free message buffer, 
the address of which is now specified by SBF.NXT. However, this 
time the message data begins at the first fullword following the 
SBF.LEN field. After this buffer is filled, the length of the 
message body is placed in the SBF.LEN field. The value in this 
field can never be larger than the maximum message length field. 


The OS continues to fetch and fill the directed task's free 
buffers until the entire message is tranferred or until no 
buffers are left on the queue. If the directed task runs out of 
buffers to hold the message data, the entire message is returned 
to the calling task buffers. The addresses of the directed task 
buffers are returned to the queue. The OS outputs an error 
message indicating no message was sent. 


If the entire message is successfully transferred, the OS places 
reason code xX'06' and the address of the first filled message 
buffer on the task queue of the directed task. If the directed 
task has been properly initialized to receive a task queue trap, 
the task then branches to a trap handling routine to process’ the 
message. It is good practice to have the trap handling routine 
return each message buffer address to the free buffer list queue 
after the data in that buffer is processed. See the 0S/32 
Application Level Programmer Reference Manual for more 
information on preparing directed tasks to handle send data 
traps. 


If the directed task trap structures have not been properly 
initialized (e.g., mo task queue has’ been established), the 
message will be returned to the calling task. 


6.2.7.3 Sample Programs Using SVC 6 Send Data Function 


“The following sample programs demonstrate the data structures 
used to send a message via the SVC 6 send data function. 
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Sample send data application: 


Sending Task 


MLIBS 8,9 
$SVC6 
SEND DS SVC6. START THE PCB 
SENDE EQU * END OF PCB 
ORG SEND+SVC6. ID GO INTO THE |I.D. FIELD 
DB C'RECDATA' STORE THE TASKID 
ORG SEND+SVC6.FUN GO TO THE FUNCTION FIELD 
DC SFUN.DOM!SFUN.DM SEND DATA:OTHER TASK 
ORG SEND+SVC6 .MSG GO TO ADDR OF DATA FIELD 
DC A(MES1) STORE THE ADDR OF THE 1ST BUFFER 
ORG SENDE GO TO THE END OF THE PCB 
MES 1 EQU * ADDR OF 1ST BUFFER 
DC Y¥'20000000'+A(MES2) 1ST BUFF+ADDR OF 2ND 
DC H'O' NOT USED BY CALLER 
DC H'80' # OF BYTES WE ARE SENDING 
DS 8 RESERVED FIELD FOR 1ST BUFFER 
DS 8 SENDING TASK NAME FOR 1ST BUFFER 
DC C'THIS IS A MESSAGE FROM ANOTHER TASK.' 
DC C'WITH THE SEND' 
DC c' ‘ TOTAL 80 BYTES 
ALIGN 4 
MES 2 EQU * ADDR OF 2ND BUFFER 
DC Y'O'+A(MES3) MIDDLE BUFFER + ADDR OF NEXT BUFF 
DC H'O' NOT USED BY CALLER 
DC H'80' # OF BYTES WE ARE SENDING 
DC C' DATA FUNCTION WE CAN SEND ' 
DC C'VARIABLE LENGTH MESSAGES TO TASKS. : 
DC C'THIS EXAMPLE’ 
DC c' , TOTAL 80 BYTE BUFFER 
ALIGN 4 
MES3 EQU = ADDR OF 3RD BUFFER 
DC Y'10000000' LAST BUFFER IN CHAIN CODE 
DC H'Q' NOT USED BY CALLER TASK 
DC H'80' # OF BYTES WE ARE SENDING 
DC C' SENT 3 BUFFERS AS ONE MESSAGE ' 
DC C'FROM ONE TASK TO ANOTHER ' 
DC C'AS ONE MESSAGE' 
DC c' : 
START EQU bs LET'S GO 
SVC 6,SEND SEND THE DATA 
LH 1,SEND+SVC6.STA GET THE STATUS 
BNZ ERROR AND BRANCH IF AN ERROR OCCURRED 
SVC 3,0 EOT 
ERROR EQU * 
svc 3,1 RETURN CODE OF 1 ON ERROR 
END START TRANSFER ADDR 
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Sample send data application: Receiving Task 


MBF STRUC STRUCTURE FOR THE MESSAGE BUFFER FORMAT 
x FUNCTION CODE FIELD 
4 ADDR OF NEXT BUFFER 
SBF .MLEN DS 2° MAX LENGTH OF BUFFER 
2 LENGTH OF DATA TRANSFER 
is START OF DATA AREA 


ENDS 
MYUDL DS 256 START OF UDL 
MYUDLE EQU- * END OF UDL 
ORG MYUDL+UDL.TSKQ GO TO TASK Q ADDR 
DC A(TRAPQ) STORE ADDR OF TASK QUEUE 
ORG MYUDL+UDL.SDQ GO TO ADDR OF FREE BUFFER LIST 
Dc A( QUEUE) STORE ADDR OF FREE BUFFER LIST 
ORG MYUDL+UDL.TSKN GO TO NEW TSW AREA FOR Q SERVICE 
DC 0 STATUS OF NEW TSW 
DC A(QSERVICE) LOCATION COUNTER OF NEW TSW 
ORG MYUDLE GO TO END OF THE UDL 
START EQU * LET'S GO 
LA 1,BUFF1 GET THE ADDR OF BUFF1 
ABL 1,QUEUE ADD TO BOTTOM OF FREE LIST 
LA 1, BUFF 2 GET THE ADDR OF BUFF2 
ABL 1,QUEUE ADD TO BOTTOM OF FREE LIST 
LA 1,BUFF3 GET THE ADDR OF BUFF3 
ABL  1,QUEUE ADD TO FREE LIST 
svc 9,TSW ENTER TRAP WAIT 
x 
QSERVICE EQU) * TRAP ROUTINE 
RBL 3,TRAPQ GET THE REASON CODE 
LR 2,3 STORE IT IN 2 
NI 2,Y'FFOOO000' CLEAR THE FIELD 
CI 2,TRC.SDTA IS IT A SEND DATA REASON CODE 
BNE ERROR BRANCH IF NOT 
DATA EQU * 
L 2,0(3) GET THE FUNCTION CODE 
NI 2,¥'FFOOOOO0' STRIP OFF THE ADDR 
Cl 2,¥'20000000' IS IT THE FIRST BUFFER 
BE FIRST 
CI 2,¥'10000000' IS IT THE LAST BUFFER 
BE LAST. 
CI 2,¥'30000000' IS IT THE ONLY BUFFER 
BE ONLY 
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NEXT 


FIRST 


LAST 


ONLY 


FINI 


8,MBF+16(3) 
9,SBF .LEN(3) 

9,8 

9,1 
8,WRITE+SVC1.SAD 
9,WRITE+SVC1.EAD 


8,MBF (3) 

9,SBF .LEN(3) 

9,8 

9,1 
8,WRITE+SVC1.SAD 
9,WRITE+SVC1.EAD 
1,WRITE 

* 


8,MBF+16(3) 
9,SBF .LEN(3) 

9,8 

9,1 
8,WRITE+SVC1.SAD 
9,WRITE+SVC1.EAD 
1,WRITE 

* 


GET THE STARTING ADDR OF BUFF 
GET THE LENGTH OF DATA TRANSFER 
ADD STARTING ADDR 

SUBTRACT ONE FROM ENDING ADDR 
STORE THE STARTING ADDR 

ENDING ADDR 

WRITE THE NEXT BUFFER 

GET THE ADDR OF THIS BUFFER 
STORE IN THREE 

CONTINUE 


GET THE STARTING ADDR OF DATA 
GET THE LENGTH OF DATA TRANSFER 
ADD THE STARTING ADDR 

SUBTRACT ONE FROM ENDING ADDR 
STORE THE STARTING ADDR 

STORE THE ENDING ADDR 

WRITE THE FIRST. BUFFER 

GET ADDR OF FIRST BUFFER 

SAVE IN THREE 

CONT INUE 


GET THE STARTING ADDR 
GET THE # OF BYTES TRANS 
ADD TO MAKE ENDING ADDR 
SUBTRACT ONE FROM END 
STARTING ADDR 

ENDING ADDR 

WRITE OUT THE LAST BUFFER 


GET THE STARTING ADDR 
GET THE # OF BYTES TRANS. 
GET AN ENDING ADDR 
SUBTRACT ONE 

STARTING ADDR 

ENDING ADDR 

WRITE THE ONLY BUFFER 


THE OS REMOVES FROM THE TOP OF THE FREE LIST 


to ) 
dg 
rm 
| 
or 
van 
(e) 


ADDR OF 1ST BUFF 
ADD TO FREE LIST 
ADDR OF 2ND BUFF 
ADD TO FREE LIST 
ADDR OF 3RD BUFF 
ADD TO FREE LIST 
GET A ZERO 

ZERO THE STATUS 
LOAD A TSW 


RETURN CODE OF 2 


START OF PCB 
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WRITEE EQU x END OF PCB 


ORG WRITE+SVC1.FC GO TO THE FUNCTION CODE FIELD 
DB SV1.WRIT!ISVL.WAIT WRITE AND WAIT 
ORG WRITE+SVC1.LU GO TO THE LU FIELD 
DB 2 LU 2 FOR A WRITE 
ORG  WRITEE GO TO END OF PCB 
ALIGN 4 
TSW EQU- * NEW TSW 
DC TSW.WIM! TSW. TSKM!TSW.SDM WAIT,Q TRAP,SEND DTA 
DC 0 LOCATION COUNTER 
ALIGN 4 
QUEUE DLIST 3 FREE LIST SIZE 
TRAPQ DLIST 3 TASK QUEUE SIZE 
BUFF 1 EQU * 1ST BUFF 
DS 4 FUNCTION CODE AND LINK ADDR 
DC H'80! MAX SIZE OF THIS BUFFER 
Dc H'0O! # OF BYTES TRANS. SET BY OS 
DS 16 RESERVED FIELD FOR 1ST BUFFER 
DS 80 # OF BYTES WE CAN ACCEPT IN BUFF 
BUFF 2 EQU* 
DS 4 FUNCTION CODE AND LINK ADDR 
Dc H'80' MAX SIZE OF THIS BUFFER 
Dc H'O! # OF BYTES TRANS SET BY OS 
DS 80 # OF BYTES WE CAN ACCEPT IN BUFF 
BUFF3 EQU- * 3RD BUFF 
DS 4 FUNCTION CODE AND LINK ADDR 
Dc H'80! MAX SIZE OF THIS BUFFER 
Dc H'O! # OF BYTES TRANS SET BY OS 
DS 80 # OF BYTES WE CAN ACCEPT IN BUFF 
END START TRANSFER ADDR 


6.2.8 Send Message (SFUN.MM) 

The send message function allows calling task to send a 64-byte 
message to the directed task. SVC 6 appends the calling task 
name to the message, finds the address of the receiving task 
buffer in the UDL of the directed task, fills the receiving 
buffer, and places the address of that buffer on to the directed 
task queue. 


The required SVC 6 parameter block fields are: 


e Task name field 
e Bits O, 1, and 11 of the function code field 


e Address of message buffer field 


To prepare a directed task to accept the message sent by the 
SVC 6 send message function: 


-@ Allocate message buffers to receive the message. (Use message 
buffer format described in Section 6.2.8.1.) 
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@ Write a routine to service task queue traps as described in 
the OS/32 Application Level Programmer Reference Manual. 


@® Store the address of the receiving message buffer in the 
address of the message buffer ring fieid in the UDL of the 
directed task. 

6.2.8.1 Message Buffers 


When allocating receiving message buffers for the send message 
function, use the buffer format shown in Figure 6-6. 


full 
bit 

eee ee Foe 
i | | i 
[O} Link { Calling task | Message H 
i {| address! name | i 
a ay Me tae Do ee fa A ERROR TET PIE Oe ERO SSR RS 4 &---- 
Bytes: 

0 3 4 ll 12 75 


Figure 6-6 Message Buffer Format for Directed Task 


This message buffer must be 76 bytes’ long and aligned on a 
fullword boundary. A description of each field in the message 
buffer format follows. 


Fields: 
Buffer-full is a l-bit field indicating whether or not the 
bit buffer can receive the message being sent from 


the calling task. 


If bit 0 equals O, the buffer is available to 
receive the message. 


If bit O equals 1, the buffer is full and the 
message is rejected. After the message sent 
by the calling task is stored in the message 
buffer, the system sets the buffer-full bit to 
1 to indicate the message buffer is full. 
After the directed task processes the message, 
the user must reset the buffer-full bit to 0 
to indicate that it is available to receive 
the next message. 
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Link address is a 4-byte field containing the address of 
the subsequent message buffer to receive the 
next message sent by the calling task. If 
this field contains an invalid address, the 
call is rejected. 


Calling is an 8-byte field receiving the calling 
task name task's name from the system. 
Message is a 64-byte field receiving the message sent 


by the calling task. 


Using the Link address field, the user can construct’ the 
following structures from the basic message format: 


1. Single buffer ring 
2. Single buffer chain 
3. Multiple buffer ring 


4. Multiple buffer chain 


A single buffer ring consists of one buffer as shown in Figure 
6-7. The buffer-full bit initially should be set to O, and the 
link address field should contain the buffer's own starting 
address (points to itself). When a message is sent to a single 
buffer ring, the system sets the buffer-full bit to 1. All 
subsequent messages are rejected until the user’ resets the 
buffer-full bit to O. 


Starting 
address 
X'150' 
aa ae ca ra | 
{ 
Data 
i 
a eo a Se De oa 4S §------------------ 
34 75 


Figure 6-7 Single Buffer Ring 
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A single buffer chain consists of one buffer as shown in Figure 
6-8. The buffer-full bit initially should be set to 0, and _ the 
link address field should contain zeros (terminating the chain). 
When a message is sent to a single buffer chain, the system sets 
the buffer-full bit to 1 and stores’ the link address field 
contents into the address of the message ring field of the UDL of 
the directed task. All subsequent messages are rejected until. 
the user stores the empty buffer address into the UDL address of 
the message ring field and resets the buffer-full bit of the 
empty message buffer to 0. 


Starting 
address 
X'150' 


See) ee EY ee ee oes ee ae eee ae ee es ee eee ee ee eee ee ee ee ey ee es ee A A OG MY eis WR CR ME eo MEE EY 


ae 
oO 
oO 
2 
=) 
» 
ct 
ry 


Figure 6-8 Single Buffer Chain 


A multiple buffer ring consists of a variable, unlimited number 
of buffers. Each buffer-full bit initially should be set to 0, 
and each link address field should contain the address of a 
subsequent buffer. The last buffer's link address field should 
contain the first buffer's address (forming a ring). Whena 
message is sent to a multiple buffer ring, the first buffer, 
pointed to by the address stored in the UDL address of the 
message ring field, receives the message if the buffer-full bit 
is 0. 


The system then stores the contents of the first buffer link 
address field into the UDL address of the message ring field. 
That UDL field now points to the second buffer in the ring. If 
the calling task sends another message, the second buffer 
receives the message if the buffer-full bit is 0. 


The system stores the contents of the second buffer link address 
field into the UDL address of the message ring field, which now 
points to the third buffer in the ring. When the last buffer in 
the ring receives a message and the contents of the link address 
field are stored into the UDL, that UDL field points to the first 
message buffer in the ring. If the calling task sends'= another 
message, the first buffer receives the message if the buffer-full 
bit is reset to 0; otherwise, the message is lost. See Figure 
6-9. 
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Figure 6-9 Multiple Buffer Ring 


A multiple buffer chain consists of a variable, unlimited number 
of buffers. Each buffer-full bit initially should be set to 0, 
and each link address field should contain a subsequent buffer 
address. The last buffer link address field should contain zeros 
(terminating the chain). When a message is sent to a multiple 
buffer chain, the first buffer, pointed to by the UDL address of 
the message ring field, receives the message if the buffer-full 
bit is O. 


The system then stores the contents of the first buffer link 
address field into the UDL address of the message ring field. 
That UDL field now points to the second buffer in the chain. If 
the calling task sends another message, the second buffer 
receives the message if the buffer-full bit is 0O. 
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The system then stores the contents of the second buffer’ link 
address field into the UDL address of the message ring field. 
That UDL field points to the third buffer in the chain. When the 
last buffer in the chain receives a message and the system stores 
the contents of the link address field into the UDL, all 
subsequent messages are rejected until the user stores an empty 
buffer address into the UDL address of message ring field and. 
resets the buffer-full bit of that message buffer. See Figure 
6-10.: 


Figure 6-10 Multiple Buffer Chain 


The following sample programs demonstrate the data structures 
used to send a message via the SVC 6 send message function. 
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Sample send message application: Sending task 


SEND PROG SVC 6 EXAMPLE - SEND MESSAGE 
x 
x This task sends a message to task RECEIVE. 
* 
x 
NLSTM 
NLSTU 
$SVC6 
$REGS 
SEND EQU x 
SVC 6,SVC6 SEND THE MESSAGE 
LB R15,SVC6+SVC6.STA+1 GET ERROR STATUS 
SVC 3,0(R15) END OF TASK 
ALIGN 4 
SVC6 DS SVC6. RESERVE SPACE FOR SVC 6 PBLK 
ORG SVC6+SVC6.ID NAME OF TASK MESSAGE IS SENT TO 


DC C'RECEIVE ' 


ORG SVC6+SVC6.FUN SEND MESSAGE TO ANOTHER TASK 


DC SFUN.DOM!SFUN.MM 


ORG SVC6+SVC6 .MSG ADDRESS OF MESSAGE TO BE SENT 


DC A (MESSAGE ) 


MESSAGE DC C'Message from SEND to RECEIVE ' 
DC ct : 
DC Cc! : 
END SEND 


Sample send message application: Receiving task 


RECEIVE PROG SVC 6 EXAMPLE - RECEIVE MESSAGE 


This task receives a message sent to it by another 
task. The message is logged to the console device. 


* © &@ GH H 


NLSTM 
NLSTU 
$UDL$ 
$REG$ 


e & & HH BH 
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Set up UDL and link message buffers into a message ring. 


RECEIVE 


LINKRING 


LINKDONE 


e &@ HM MH 


QSERVICE 


QEMPTY 


TRAPENA 


svc 


EQU 
RTL 
BO 
LA 
SRL 
CLHI 
BNE 
LA 
ST 
svc 
L 
NI 
ST 
L 
CLI 
BNE 
svc 


EQU 
SVC 


x 


2,FETCHPTR 

R14, TSW. PMM 
R15,QSERVICE 
R14,UDL.TSKN(RO1) 
R15, TSKQ 
R15,UDL.TSKQ(ROL) 
R15,MESSQ 
R15,UDL.MSGR(RO1) 


R15,NMESS 
R14,MESSQ 
x 


R15,1 
LINKDONE 
R13,76(R14) 
R13,0(R14) 
R14,R13 
LINKRING 


x 


R13 ,MESSQ 
R13,0(R14) 


9, TRAPENA 


Service task queue traps 


x 


RO2,TSKQ 
QEMPTY 
R15,0(RO2) 
RO2,24 

RO2,6 
QSERVICE 
R14,4(R15) 
14, LOGMESS+4 
2 ,LOGMESS 
ROO,0O(R15) 
ROO,Y‘'7FFFFFFF' 
ROO,O(R15) 
ROO, 12(R15) 
ROO,C'STOP' 
QSERVICE 

3,0 


x 


9,TRAPWAIT 


ALIGN 4 
DC TSW. PMM, 0 


GET ADDRESS OF UDL IN ROL 

ALLOW MESSAGES TO BE QUEUED 
ADDRESS OF QUEUE SERVICE ROUTINE 
SAVE TASK QUEUE NEW TSW 

ADDRESS OF TASK QUEUE 


ADDRESS OF MESSAGE BUFFER RING 


NUMBER OF MESSAGES IN RING 
HEAD OF MESSAGE RING 


GET ADDRESS OF NEXT BUFFER 
LINK NEXT TO CURRENT 
CURRENT [S NEXT 

CONTINUE LINKING OF RING 


ADDRESS OF FIRST MESSAGE 
LINK FIRST TO LAST 


ENABLE RECEIVE OF MESSAGES 


A ITEM ON THE TASK QUEUE? 

NO - ENTER TRAP WAIT 

GET PARAMETER 

ISOLATE REASON CODE 

MESSAGE RECEIVED? 

NO - IGNORE IT 

SKIP OVER MESSAGE LINK 

ADDRESS OF MESSAGE TO BE LOGGED 
LOG SENDER ID AND MESSAGE 

RESET MESSAGE ACTIVE FLAG 


GET FIRST FOUR BYTES OF MESSAGE 
IS IT "STOP"? 

NO - CHECK FOR MORE MESSAGES 
YES - STOP TASK 


ENTER TRAP WAIT 
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TRAPWAIT DC TSW.WTM! TSW. TSKM! TSW. PMM, 0 


FETCHPTR DB 0,5,0,RO1 FETCH UDL POINTERS 
LOGMESS DB X'40',7 

DCX 72 

DC 0 
TSKQ DLIST 5 | TASK QUEUE 
NMESS EQU 3 NUMBER OF MESSAGE BUFFERS 
MESSQ DS 76*NMESS MESSAGE BUFFERS 


END RECEIVE 


6.2.9 Queue Parameter (SFUN.QM) 


The queue parameter function adds the user-specified parameter, 
located in the task queue parameter field of the parameter block, 
to the directed task queue. The required parameter block fields 


are: 
e Task name field 
e Bits 0, 1, and 12 of function code field 


e Task queue parameter field 


Before the directed task can receive the parameter sent from the 
calling task, the directed task must prepare to service traps as 
described in the OS/32 Application Level Programmer Reference 
Manual. 


If the directed task queue is full, the call is rejected, the 
parameter is lost, and an error code is stored into the error 
status field of the parameter block. 


6.2.10 Change Priority (SFUN.PM) 

The change priority function changes the directed task's current 
priority to the user-specified priority located in the parameter 
block change priority field. It then stores the change priority 
value at which the directed task is now executing into the 
current priority field of the parameter block. The required 
parameter block fields are: 

e Task name field 


e Bits O, 1, and 13 of the function code field 


-@ Change priority field 
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If the change priority value specified in the parameter block is 

greater than the maximum priority value established by Link, that 

maximum priority is used. However, if the change priority value 

the user specified is outside the range of 10 through 249, the 

call is rejected, and an error code is stored in the parameter 

block error status field. See Table 6-5. 

6.2.11 Send Logical Unit (SFUN.XSM) 

The send logical unit function assigns to the specified lu of the 

directed task the device or file currently assigned to the 

specified lu of the calling task, and then closes the lu assigned 

to the calling task. The required parameter block fields are: 

e Task name field 

e Bits O, 1, and 14 of the function code field . 

e Calling lu field 

e Receiving lu field 

Before the directed task accepts the lu that the calling task 

sends: 

e the directed task's lu must not be assigned, and 

e the directed task must be in either a dormant or paused wait 
state or be suspended by an SVC 6. 

6.2.12 Receive Logical Unit (SFUN.XRM) 

The receive logical unit function assigns to the specified lu of 

the calling task the device or file currently assigned to the 

specified lu of the directed task, and then closes the lu 

assigned to the directed task. The required parameter block 

fields are: 

e Task name field 

e Bits O, 1, and 15 of the function code field 

e Calling lu field 


@® Receiving lu field 
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Before the calling task accepts the lu that the directed task 

sends: 

@ the calling task's lu must not be assigned, and 

e the directed task must be in either a dormant or paused wait 
state or be suspended by an SVC 6. 

6.2.13 Connect (SFUN.OM) 

The connect function connects’ the _ trap generating device 

specified in the device mnemonic field of the parameter block to 

the directed task. The required parameter block fields are: 

e Task name field 

e Bits 0, 1, and 16 of the function code field 

e Device mnemonic field 


e Task queue parameter field 
Before the connection is made: 


e The user-specified device must be a trap generating device. 


e The device must not be currently connected to the directed 
task or any other task; it can be connected to only one task 
at a time. However, a task can be connected to more than one 
trap generating device at the same time. 


e The directed task must be prepared as described in the 0S/32 
Application Level Programmer Reference Manual if traps are to 
be serviced as they occur. 


When the connection is made and the thaw function is’ specified, 
an interrupt occurs, and the user-specified parameter located in 
the task queue parameter field of the parameter block is’ placed 
on the directed task queue with a reason code of 0. The connect 
function does not enable interrupts. 
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6.2.14 Thaw (SFUN.TM) 


The thaw function enables interrupts from the specified trap 
generating device connected to the directed task. The required 
parameter block fields are: 


e Task name field 
e Bits O, 1, and 17 of the function code field 


e Device mnemonic field 


Before this function is effected, the task should be prepared to 
handle traps as described in the OS/32 Application Level 
Programmer Reference Manual. 


When the thaw function is executed, the system first ensures that 
the trap generating device is connected to the directed task 
specified in the parameter block; it then enables interrupts. 
Interrupts are disabled when the directed task terminates or if 
an unconnect or freeze function is specified. If a thaw function 
is executed when interrupts are already enabled, this call has no 
affect. 


6.2.15 Sint (SFUN.IM) 

The sint function simulates an interrupt from the specified trap 
generating device connected to the directed task only if the thaw 
function was’ specified. If interrupts are disabled, this call 
has no affect. The required parameter block fields are: 

e Task name field 

e Bits O, 1, and 18 of the function code field 

e Device mnemonic field 

When the simulate function is executed, the system first ensures 
that the trap generating device is connected to the directed task 


specified in the parameter block; it then simulates an interrupt 
from the specified device. 
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6.2.16 Freeze (SFUN.FM) 


The freeze function disables interrupts from the specified trap 
generating device connected to the directed task. The required 
parameter block fields for this function are: 


e Task name field 


e Bits O, 1, and 19 of the function code field 


@ Device mnemonic field 


When the freeze function is executed, the system first ensures 
that the trap generating device is connected to the directed task 
specified in the parameter block; it then disables interrupts 
from the specified device. When the freeze function disables 
interrupts, the trap generating device and directed task remain 
connected, but all generated interrupts are lost. If interrupts 
are already disabled, this call has no affect. 


6.2.17 Unconnect (SFUN.UM) 

The unconnect function disconnects the specified trap generating 
device from the directed task. The required parameter block 
fields for this function are: 

e Task name field 

e Bits O, 1, and 20 of the function code field 

e Device mnemonic field 

When the unconnect function is executed, the system first ensures 
that the trap generating device is connected to the directed task 
specified in the parameter block; it then disables all interrupts 
and disconnects the specified device from the directed task. The 
device can now be connected to another task. 

6.2.18 Assign LPU (SFUN.LPU) 

The assign LPU function assigns a logical processing unit number 
to the directed task. This assignment has no effect until the 
directed task is transferred by the task dispatcher. The 
required parameter block fields for this function are: 

e Task name field 


® Bits O, 1, and 21 of the function code field 


e LPU assignment field 
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6.2.19 Transfer to LPU (SFUN.TL) 


The transfer to LPU function sets the LPU-directed status field 
in the TCB of the directed task. As a result, the directed task 
is transferred to its assigned LPU the next time the task is 
dispatched, provided that all requirements for transfer are met. 
See the OS/32 System Level Programmer Reference Manual for more 


information on the task dispatcher. If this function is 
self-directed and the calling task is executing on an APU, no 
transfer occurs. If a calling task executing on the CPU directs 


this function to itself, the LPU-directed status field in the TCB 
is set and the calling task is dispatched to its assigned LPU. 
If the LPU is mapped to the CPU, no transfer occurs. If the LPU 
is mapped to an APU, a transfer to the APU occurs. 


The required parameter block fields for this function are: 


e Task name field 


e Bits O, 1, and 22 of the function code field. 


NOTE 


If both bits 22 (SFUN.TL) and 23 
(SFUN.TC) are set in the same SVC 6 
parameter block, only bit 23 is 
recognized when the call is complete. 


6.2.20 Transfer to CPU (SFUN.TC) 


The transfer to CPU function resets the LPU-directed status field 
in the TCB. As a result, the next time the task is dispatched 
from the CPU ready queue, it will execute on the CPU regardless 
of its LPU assignment and eligibility. If the calling task 
directs this function to a task that is active or ready on an 
APU, the LPU directed status is reset after the task is returned 
to the CPU for processing. 


If a calling task executing on the CPU directs this function to 
itself, no transfer occurs. If a calling task operating on the 
APU directs this function to itself, the calling task is 
transferred to the CPU. Normally, APU processing continues after 
the task is transferred unless the wait bit in the SVC NEW PSW 
field of the APU trap block has been set. In this case, APU 
processing is explicitly suspended while the task executes on the 
CPU until: 


e the task is explicitly transferred back to the APU via SVC 6, 
or 


e the task is assigned to a different APU through an LPU 
assignment, or 
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e the task is cancelled or goes to end of task, or 


e LPU mapping for the task's LPU is changed. 


See the 0S/32 Application Level Reference Manual for more 
information on setting the trap block to suspend APU processing. 
The required parameter block fields for this function are: 


e Task name field 


e Bits 0, 1, and 23 of the function code field 


NOTE 


If both bits 22 (SFUN.TL) and 23 
(SFUN.TC) are set in the same SVC 6 
parameter block, only bit 23 is 
recognized when the call is completed. 


6.2.21 Release (SFUN.RM) 

The release function releases a directed task currently suspended 
by a previous SVC 6 by taking it out of a wait state. Once 
released, the task continues executing with the instruction 
following the instruction executed before the task was suspended 
if the task is not in another wait state at this time. The 
required parameter block fields for this function are: 


e Task name field 


e Bits O, 1, and 24 of the function code field 


6.2.22 Nonresident (SFUN.NM) 

The nonresident function makes the directed task nonresident 
regardless of the Link options specified. When a nonresident 
task goes to end of task, it is removed from the _ system. The 
required parameter block fields are: 


e Task name field 


e Bits O, 1, and 25 of the function code field 
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6.2.23 Rollable (SFUN.RLM) 

The rollable function makes the directed task rollable. The 
directed task must have been linked as a rollable task. If this 
function is directed to a task linked as’ nonrollable, an error 
status is returned. The required parameter block fields are: 


e Task name field 


e Bits 0, 1, and 26 of the function code field 


6.2.24 Nonrollable (SFUN.NRM) 

The nonrollable function prevents the directed task from being 
rolled. The required parameter block fields are: 

e Task name field 

e Bits 0, 1, and 27 of the function code field 

If both rollable and nonrollable functions are specified, only 
the nonrollable function is recognized. 

6.2.25 Start (Bit Positions 29, 30, 31) 

The start function starts execution of the directed task. This 
call is rejected if it is self-directed. Four methods of 
starting are: 

1. Start (bit setting equals O10) 

2. Start with start options (bit setting equals 011) 

3. Delay start (bit setting equals 100 or 110) 


4. Delay start with start options (bit setting equals 101) 
The required parameter block fields are: 


e Task name field 
e Bits 0, 1, 29, 30, and 31 of the function code field 
@ Address of start options field (only required when start with 


start options or delay start with start options is specified 
in the function code) 
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e Increment of time field (only required when delay start or 
delay start with start options is specified) 


e Count field (only required when delay start or delay start 
with start options is specified) 


e® Starting address of directed task field 
Before the start function is executed, the directed task must be: 


@ loaded or present in memory, and 


@® ina dormat or console wait state. 


6.2.26 Start Function for SVC 6 (SFUN.SIM) 


When this function is specified, execution of the directed task 
is started at the address in the parameter block starting address 
of the directed task field. However, if the user-specified 
starting address is 0, the directed task is started at the 
default start address specified by Link. If the user-specified 
starting address is outside the established task boundaries, this 
call is rejected, and an error code is stored in the parameter 
block error status field. 


6.2.27 Start Function with Start Options for SVC 6 (SFUN.SOM) 


When this function is specified, the start options, optionally 
specified in certain language and utility programs at execution 
time, are also included as run time information when the directed 
task starts execution. When the start function is executed, the 
start options located at the address specified in the parameter 
block are stored into the directed task UTOP area. If sufficient 
memory is not available between UTOP and CTOP, this call is 
rejected and an error code is stored in the parameter block error 
status field. The task should then be reloaded into a larger 
segment using the extended load option segment size increment 
field. 


The user-specified start options must be located on ae fullword 
boundary. The maximum length of the start options are defined at 
system generation (sysgen) time through the CMDLENGTH option. If 
the length of the start options is greater than that specified at 
sysgen time or a carriage return is present within the start 
options, only those characters up to the maximum number or the 
carriage return are stored in the task UTOP area. 


Since the address of the start options field is also the address 
of the message buffer field in the parameter block, this field's 
contents are always assumed to be the start option address when 
the start function is specified. 
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6.2.28 Delay Start Function for SVC 6 (SFUN.SDM) 


When this function is specified, the directed task starts 
execution after a user-specified interval located in the 
parameter block increment of time and count fields elapses. The 
interval can be specified as a time of day or interval timing 
interval. 


When this start function is executed for the directed task, bytes 
192 through 251 of the UDL are used by the OS for SVC 6 delay 
start function use. 


When this start function is executed, the directed task is 
immediately placed into a time wait state. When the 
user-specified interval elapses, the directed task starts 
execution. 


6.2.29 Delay Start Function with Start Options for SVC 6 
(SFUN.SDM, SFUN.SOM) 


When this function is specified, the directed task starts 
execution after a user-specified interval located in the 
parameter block increment of time and count fields elapses. The 
interval can be specified as a time of day or interval timing 
interval. 


When this start function is executed for the directed task, bytes 
192 through 251 of the UDL are used by the OS for SVC 6 delay 
start function use. 


When the start function is executed, the start options located at 
the address specified in the parameter block are stored into’ the 
directed task UTOP area, and the directed task is immediately 
placed into a time wait state. If sufficient memory is not 
available between UTOP and CTOP, this call is rejected, and an 
error code is stored in the parameter block error status field. 
The task should then be reloaded into a larger segment using the 
extended load option segment size increment field. See Section 
6.2.4.2. 


The user-specified start options must be located on ae fuliword 
boundary. The maximum length of the start options is defined at 
sysgen through the CMDLENGTH option. If the length of the start 
options is greater than that specified at sysgen or a carriage 
return is present within the start options, only those characters 
up to the maximum number or the carriage return are stored in the 
task UTOP area. Since the address of the start options field is 
also the address of the message buffer field in the parameter 
block, this field's contents are always assumed to be the address 
of the start options when the start function is specified. When 
the user-specified interval elapses, the directed task starts 
execution. 
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6.2.30 Wait Status Field (SVC6.TST) 


The wait status is sent to the wait status field in the parameter 
block each time SVC 6 is executed. 


If the calling task wants to check the wait status of the 
directed task, an SVC 6 should be executed with bits 0 and 1 of 
the function code set to 10 and the remaining bits set to 0. 
This operation also causes the current priority field of the 
directed task to be returned to the current priority field in the 
parameter block. Table 6-4 lists the wait status bit 
definitions. 


TABLE 6-4 WAIT STATUS BIT DEFINITIONS 


H BIT {| WAIT STATUS |} | 
Hace Beh ln RR ns 
7 O (IO) ; X*'8000! | I/O queue wait | 
| 1 (CN) { X'4000" {Connection wait | 
| 2 (CW) | X'2000' —} Console wait (task paused) ! 
| 3 (LW) { X'1000' | Load wait; calling task waiting | 
| 7 Bee ciatecdikiaian Je enna ame carb 
| 4 (DM) } x'o800' i Dormant; task not started or at 
ee ee a ee cee : 
! 5 (TW) { X‘'0400' ; Trap wait | 
| 6 (TD) 1 X'0200' —} ‘Time of day wait | 
| 7 (TK) 1 K'0100' | ‘Task suspended | 
| 8 (TM) } X*0080' | _ Interval wait | 
| 9 (PR) | 10040" | Terminal wait | 
| 10 (RO) | X'0020' | Roll pending wait = | 
| 11 (11) | X*0010' | Intercept initialization | 
| 12 (IT) | K'0008' | Intercept termination | 
| 13 (CO) } X'0004' | Connection wait = ! 
| 14 (AC) | K'0002' «| Accounting wait sits | 
is | x"0001'  ~+~| Reserved for future use ! 
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6.2.31 Error Codes (SVC6.STA) 


If an error occurs, execution of the current SVC 6. function 
stops, and any other functions specified in the function code to 
the right of the current function are not executed. The position 
of the function code bit, which indicated the function being 
executed when the error occurred, is stored in bits 0 through 7 
of the parameter block error status field. The bit position 
value ranges from 0 through 31. The error code indicating the 
error type is stored in bits 8 through 15 of the parameter block 
error status field shown in Figure 6-11. Table 6-5 lists SVC 6 
error codes. 


— oe ee ee Oe ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee nee ee ee ee ee ee ee 


i Function code |; 
i bit position H Error code 


Figure 6-11 Error Status Field 


TABLE 6-5 SVC 6 ERROR CODES 


ERROR {FUNCTION CODE} 


1 H 
H CODE {BIT POSITIONS | | 
|HEXADECIMAL} CAUSING THE } H 
| (DECIMAL) | ERROR H MEAN ING i 
f 0 H All ' No error occurred. All | 
H { requested functions terminated H 
{ normally. 
Pees SaaS oat SS eee eee ea SaaS eS SSS eae SSS H 
i 1 | All i Syntax error present in ! 
i parameter block task name field. 
i H ' This error does not include self- H 
i ! ! directed calls. 1 
PSS SS renee SSe See SS SS ee SS See eae See ae eee Se H 
H 2 i All | Illegal function code : 
fgets oe ce ee dS eo cee apn ee VT pA NE ny CN pig eaptE mG MOTT Oe WEN BL a Oo ey eI ee Ce RY ee eee ae eg ot oe H 


i Directed task is already loaded 
;} into memory. 
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TABLE 6-5 SVC 6 ERROR CODES (Continued) 


— ee ee ee see ee ee ee ee ee em ee eee ee we ce ee ee ee ee ee ee ee ee. ee ce ee ee ee em eee ee ee ee ee 


ERROR iFUNCTION CODE} 


| 
' 
H CODE ;BIT POSITIONS} 
|}HEXADECIMAL; CAUSING THE } 
| (DECIMAL) } ERROR MEAN ING 
\ SESS SSS SSS SSS ws SS SE SS SE OE A SE SE 2 ee 2 6 2 Se EO OS oe st ee 2 es Be 2 2 a 2 2 2 es 2 Se 
H 4 | All except ; The specified directed task is not 
H \ 6 (L) i present in the calling task 
i environment. 
aaa aa aa a al a ma 
6 (L) i The directed task is not present, 
} but the calling task has the SVC6 
{| intertask control function dis- 
{| abled. : 
H ee ee ee ee ee ee ee ee ee a a a a a a a a a a a a a i ee 
1 5 H 13 (P) i The specified priority is outside 
H { ;} the range of 10 through 249. 
H cee ae Sem eae em cm ree ce ee re cee SO OOD eH aD SO OD Se ED Oe SOD SS ED Se SUE om OS ee ae Oe ee me fe we we ee ee me ee ee oe we 
H 6 H 6 (L) | The directed task requires float- 
i H } ing point facilities that are not 
{ H i sysgened into the system. 
H tn ec ci Ss" ‘we wt ces Si mm sls Sa Sn Gp at“ mcm “Sg i eee enn‘ iam Gay em eu ‘oc i Suh ely“ po 
H 7 H 9 (S) | The specified directed task is 
| Gormant, paused, or suspended. 
| i 14 (B) i The specified directed task is not 
i 15 (V) | Gormant, paused, or suspended. 
29 i 
i 30 (A) 
31 : 
H eat ce sr Se “a a a “a a a i fe a a ps a ee 
8 11 (M) The message is not aligned ona 
29 fullword boundary or an invalid 


i 30 (A) ; starting address was specified for 
! 1 
t { 


31 a directed task. 
ae eRe teeta Ree one e ee ees aoe eee eee eee ee tee 
| 9 H All | The calling task cannot execute 
{ H | SVC 6 control or communication 
{ H } functions. 
H a a cs ee, emi Sts“, a Sm“ oar Seta we fe te‘ iis, a ei eh aes eso as‘seem sa Seen anos nee Ses wom, Ss 
A (10) |} 29 i The values specified for the 
{ { 30 (A) i imcrement of time and count 
31 | fields are invalid. 
| ses sem ‘cee imc car mms ce cn” em (cm s(n Si “i's Gs» a mG ns > Sess Sabo ti Sao SOs Scum. e's ui” a “tums “hems Gu Cem sce“ OO 
Hl B (ll) | 11 (M) i The calling task message was not 
H | 10 (SD) i sent to the directed task. 
| fs i hc a, mc Cm fais nr‘ mc | es hi Sr) Ss asin, a we es ee cS “ve ees ie ni, Saree es cc Gee ee, i’ 
Cc (12) 10 (SD) Task queue service in the directed 
task TSW is disabled. The 


I 
12 (Q) | Girected task queue is full. The 
i GQirected task has no queue. 


——_ ee ee we ee ee we Se oe 


48-038 FOO ROL 6-45 


TABLE 6-5 SVC 6 ERROR CODES (Continued) 


me WR mem ma cee GY ON ete ome Sem ee co ee See Se SG ee ee ee SS SU ee ee SS Oe DS me OD GD Se Ge a GE Re ee ee OE ee eee ce ane Oo me ee Oo 


me ey cm ene ES GS ei mS ue ets ce ecm eee seem ee etree ee ee a ee eee a ce ee ee eee ee ee ee ee cee) Re ee ee OR ee ee 


aeciceene tie ti ceil i es A ene ee ee ee See 


H ERROR {FUNCTION CODE} 
\ CODE ‘BIT POSITIONS} 
|}HEXADECIMAL | CAUSING THE 
| (DECIMAL) } ERROR 
D (13) i 16 (0) 
47 (8) 
' 48 (1) 
i H 19 (F) 
! ' 20 (UD) 
H E (14) H 16 (0) 
! | 17 (P) 
! ' 48 (1) 
! 1 19 (F) 
! ' 20 (U) 
, IF 4s) 4 ie (OD 
! ! 

10 (16) H 17 (T) 
{ i 18 (I) 
! ' 19 (F) 
! ' 20 (U) 
/ 41 (17) =} 6 (L) 
12 (18) i 14 (B) 
! / 15 (Vv) 
13 (19) H 14 (B) 
/ 15 (Vv) 
H 14 (20) i 14 (B) 
! 1 15 (Vv) 
16 (22) i 29 

i H 30 (A) 
{ 17 (23) i 26 (Y) 
6-46 


MEAN I NG 


The device mnemonic specified in 
the parameter block does not exist 
in the system. 


The device mnemonic specified in 
the parameter block is not a con- 
nectable device. 


The device mnemonic specified in 
the parameter block is busy and 
cannot be connected. 


The device mnemonic specified in 
the parameter block is not con- 
nected to the specified directed 
task. 


The lu specified in the lu to load 
task field of the parameter is 
invalid. 


The lu the calling task sends or 
receives is greater than the 
maximum allowed value. 


The directed task is currently 
assigned to an lu during a send lu 
operation. 


The calling task is currently 
assigned to an lu during a receive 
lu operation. 


The specified directed task to be 
started is currently rolled out. 


The directed task did not specify 
the roll option by Link and 
therefore cannot be rolled out. 
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TABLE 6-5 SVC 6 ERROR CODES (Continued) 


I i i ee ee Nr i dd 


ERROR {FUNCTION CODE} 


CODE i;BIT POSITIONS; 
HEXADECIMAL {| CAUSING THE |} 
(DECIMAL) | ERROR MEAN ING 


SS 5 = SS SE SS OS SE Oe es 2 2 0 2 SS a 2 Es 2s 2 2 ES 2: OS Oe 2 2 2 es 2 a 2 2 es 2 2 2 2 2 BS Oe ES 


18 (24) H 29 i There is insufficient room between 
{ 30 (A) | the task UTOP and CTOP to store 
i I 
' { 


31 the task specified start options. 
(cas aee eae a ee eee eae et ee aie ame eters 
; 19 (25) | 18 (T) i An interrupt cannot be simulated 
H | on the specified device. 
| eee ee ae cee re eee cm mm tem ee ee ee ee ee ee cae ce Oe SD Sm Sm ae caer cam ces me se Se ee ee eee ee 
i; 1B (27) H 6 (L) {| Loading the direct task will 
{ ; exceed the maximum number of 
H { i sysgen-established tasks that can 
ij be present in the system at one 
{| time. 
\ fm ene ee ee ee ee ee me eee eee cee a mee cee eee ree ee ene ce eee me ce ee oe ee ee eee ee ee ee 
; 21 (23) H 6 (L) | An error occurred while loading a 
H i ; pure segment. 
| ce mee rence me meee nome om eee ne wren eee ee re mmm mm nm cee cre ce ore cam ce eee nae ee eee ee ee ee ee ee eee ee ne ee ee oe ee 
; 42 (66) | 6 (L) i The RTL or a TCOM required by the 
i | Girected task is not present at 
H {| load time. 
' a ee ee nearer ee es 
| 43 (67) H 6 (L) | The calling task specified load 
H H | options and the directed task 
i | specified link options are not the 
{ game. 
! ee a ee ee ee ee ee ee ee ee ee ee ee ee ee 
|} 44 (68) i 6 (L) i The LIB format is invalid. 
i 45 (69) | 6 (L) i Insufficient system space exists 
\ H 14 (B) ' to load or start the directed 
H | 15 (V) i task. There is insufficient 
H H 29 | system space in the directed task 
H H 30 (A) | to accept the lu of the calling 
H 31 ; task being sent. 
i me ee emer ee eee ee ee eee ee eee ee ce ee ee cre ee ee ee ce ee ee ee ee nee we cee we ee ee ee eee ee ee 
i 46 (70) | 6 (L) {| Attempt was made to load tree- 
{ H | structured overlays from a device 
H { | that does not support random 
{} access. 
i a ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee eee ee 
i 47 (71) $ 6 (L) { System does not support loading 
{| of tree-structured overlays. 
H mee eee ee nee ee ne ee me wee ee eee ee ee ee eee ee eee ee ee a ee ee ee ee ee ee ee 
48 (72) 6 (L) Data in the overlay descriptor 


1 
{ 
i table (ODT) of a tree structured 
{| overlay is invalid. 


me ewe eee ee ee ew ee ee ee 
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TABLE 6-5 SVC 6 ERROR CODES (Continued) 


H ERROR iFUNCTION CODE} 
{ CODE iBIT POSITIONS} 
i HEXADECIMAL{| CAUSING THE 

| (DECIMAL) | ERROR 

' SS SSS SES SPS BSS SS SS SS SS SS SS 


49 (73) | 6 (Lb) 


MEAN I NG { 

Be SBa eS SSS ek SEER SESS SSS SST Ss SVB SESBS ss =z H 
Memory does not have a large H 

enough area into which the H 

directed task can be loaded. The  ; 

roll option was not specified as a |} 

Link option. { 

Se i cen smn “nb ins ew Ren ion “cm us ees" ae sis “cans ems ices” mm Sasi vs “ms Gms “Com, ses “cm tua i min, "cl “scm SY “Ges GG Tm ess, ns cet, Umn 6 ' 
| Error occurred while mapping a H 
{ shared segment. Previously mapped ; 
| { 
4 i] 
‘ 


or shared segment table was full. 
i The allocation of or assignment to | 
i the specified roll file is invalid, } 
| and the task cannot be loaded. H 
iy: Si i a sca i, i “cs: oi wisi: em. fm tle" ee oi: de ia “i a in ssc a ig “ct es” Si Sa slew pik cha "essa aii “wi ‘te Vn es i mses i 
i; An I/0 error occurred when the | 
i GQirected task was rolled out i 
i (written) to the roll volume; it 
; cannot be loaded back into memory. |} 
Ves i: ey, ais <i a cmp “ws Sei Seat “ng em: ek sm i wa sol“ "ass asin: “Gals en “eis “ns “cus nwa man tb pc sae ‘oie’ ees i “psa wae. pa i ss { 
i The physical size of a sharable | 
{ segment was smaller than the } 
i minimum size required. H 
Ss es stn css a cin mgs i= Caen ci. mm ii’ “eset sms sks “in “petunia tm tm mis “mpi ‘ep. tgs wes Tees Cas Ves i ests mnt ce ies CnC ' 
i The access privileges of a H 
i Sharable segment were incompatible | 
i with those requested by the task. H 
| The LPU number is outside the \ 
; range specified by the MAXLPU 
} parameter at sysgen. i 
"sb ais “i: mms ~ tn hi “Se vce sans casts i is" ms nuns” sce“ ” esl ad <Gt Bums tsetse cals ce“ nhac bmn“ “Ges els bk “dho eck Ces. ets ik a ee es eS a ee es t 
| The directed task is an APU-only 
H 23 (IC) | task and cannot be transferred to } 
} } the CPU. } 
‘sins’ ac “anamnestic “ts ues "wis iwi “se cesses “sect es Sas cea. “cess bes in Sin ils Seven ans Ses - Gua an ees as Se Sa ie aay ag ican ae Ss a eae ‘] 
80-FF { An I/O error occurred when the H 
| directed task was being loaded H 
i (read) into memory. An SVC l H 
i error occurred. H 


Oe a A A A SY A A SS ee SS SL VS en GAY Se NY ee SE me een eee) mn eee Aine Get See GES GR ee ne SO SS Se ame EE SUES ee eee SL me ne ee ee es me ee ne es le em 


The calling task can check the parameter block for functions’ the 
directed task executed before the error occurred and for 
functions that were not executed. 
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CHAPTER 7 
FILE HANDLING SERVICES SUPERVISOR CALL 7 (SVC 7) 


7.1 INTRODUCTION 


SVC 7 provides file and device handling functions supported by 
the file manager and the data communications subsystem. These 
functions are accomplished through the SVC 7 parameter block 
shown in Figure 7-1. For a description of the 0S/32 file 
management services, see the OS/32 Application Level Programmer 
Reference Manual and the 0OS/32 Basic Data Communications 
Reference Manual. 
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Ce A ee ee ee ee es Se ed ee ee 


10(0) 12(2) 13(3) | 
i Function code | Error status |} lu | 
} (SVC7.OPT) | (SVC7.STA) H (SVC7.LU) i 
i gh a a ea a a cd H 
14(4) i5(5) 16(6) i 
{| Write key H Read key | Logical record length I? 
i (SVC7.WKY) H (SVC7.RKY) | (SVC7.LRC) | 
ca esa na a al aa a a la a i 
18(8) H 
i Volume name or device mnemonic I 
H (SVC7. VOL) | 
Comics acavumecud gon maroon ae ace ENG eCEREan Une DER daNnicoe aks 
{12(C) 
i 
| | 
peScere Filename 00 2 Rte 
{16(10) (SVC7.FNM) \ 
{ ; 1 
! ! 
Peas Spa ne ee ER a Se ee ane 
120(14) 123(17) Fille | 
H Extension {| class/account | 
H (SVC7.EXT) i (SVC7.ACT) 1 
Ieper agen ane oe onan 2 A ean ae eee nae mes 
124(18) 
H File size | 
| (SVC7.SIZ) | 

SVC 7,parblk 

ALIGN 4 

parblk DC X'function code' 

DS 1 

DB lu ; 

DB ‘write key' 

DB ‘read key' 

DC H'record length' 

DC C'4-character volume name or device 

mnemonic ' 

DC C'8-character filename' 

DC C'3-character extension' 

DB C'file class' 

DC F'file size' 


Figure 7-1 SVC 7 Parameter Block Format and Coding 
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This parameter 


block must be 28 bytes long, fullword-boundary 


aligned, and located in a task writable segment. A description 
of each field in the parameter block follows: 


Fields: 


Function 
code 
(SVC7.OPT) 


Error 
status 
(SVC7.STA) 


lu 
(SVC7.LU) 


Write key 
(SVC7 .WKY) 


Read key 
(SVC7.RKY) 


Logical 
record 
length 
(SVC7.LRC) 
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is a 2-byte field that contains the 
hexadecimal number indicating the function to 
be performed. 


is a l-byte field that receives the 
appropriate error code when an error occurs 
while executing SVC 7. If no error occurs, a 
value of 0 is stored in this field. 


is a l1-byte field that contains a hexadecimal 
number indicating the logical unit used for 
all SvC7 functions (except the allocate and 
Gelete functions). 


is a l-byte field that contains a hexadecimal 
number indicating the write protection keys 
for direct access and data communications 
files and devices when the allocate, assign, 
reprotect and delete functions are executed. 


is a l-byte field that contains a hexadecimal 
number indicating the read protection keys for 
Girect access and data communications files 
and devices when the allocate, assign, 
reprotect, and delete functions are executed. 


When executing the SVC 7 fetch attributes 
function, the device and file attributes are 
stored in the write and read key fields of the 
parameter block. 


is a 2-byte field that contains a decimal 
number indicating the logical record length 
for indexed files, nonbuffered indexed files, 
or buffered logical terminal manager 
(communications). 


When executing a fetch attributes function, 
this field receives a hexadecimal number 
indicating a file logical record length or a 
device physical record length. 


Volume name 
or device 
mnemonic 
(SVC7.VOL) 


Filename 
(SVC7.FNM) 


Extension 
(SVC7 .EXT) 


File class/ 
account 
(SVC7.ACT) 


is a 4-byte field that contains ASCII code 
indicating the volume name of a direct access 
device, the device mnemonic of a nondirect 
access device or name of the data 
communications access line, when the allocate, 
assign, delete, and fetch attributes functions 
are executed. 


is an 8-byte field that must contain the ASCII 
code indicating: 


e A filename on a direct access device when. 
the allocate, assign, rename, and delete 
functions are executed. A filename is not 
required for nondirect access devices. 


e The buffered logical terminal described by 
the LCB that is being allocated or 
assigned. 


When executing a fetch attributes function, 
this field receives the filename from the 
direct access or data communications device 
currently assigned to the lu specified in the 
parameter block. If it is a nondirect access 
device, this field is blank. 


is a 3-byte field that contains the ASCII code 
indicating further identification of the 
filename or the file type (.CAL, .OBJ, .TSK, 
-CSS) on direct access devices. 


is an optional l-byte field that contains the 
account or class to which the file is 
allocated. If SVC 7 is issued by an e-task or 
a u-task that was’ link-edited with the 
ACPRIVILEGE option, an account number can be 
specified in this field. 


NOTE 


To allocate a file with an account 
number, the file descriptor (fd) 
must be packed into the SVC 7 
parameter block using SVC 2 code 
16 (See Section 3.14.9.) The 
account number can range from 0 
through 65,535. 
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If SvC 7 is issued by a u-task that was 
link-edited with the NACPRIVILEGE option, the 
file class is specified as follows: 


@e P indicates file is allocated under a 
private account. 


e G indicates file is allocated under a 
group account. 


e S indicates file is allocated under a 
system account. 


See the OS/32 Link Reference Manual for more 
information on the account privileges task 


option. 
File size is a 4-byte field that contains a hexadecimal 
(SVC7.SIZ) number indicating the file size established 
when a file is allocated to a direct access 
device. 


7.2.1 Function Code Field (SVC7.OPT) 


SVC 7 has nine functions specified by the first byte of the 
function code, called the command byte, and has three modifier 
fields specified by the second byte of the function code, called 
the modifier byte. The modifier fields are: 


@ access privileges for the allocate function and change access 
privilege function, 


@® access method (data communications only) for the assign 
function, and 


e file types for the allocate function, 

@e density selection for the assign function (magnetic tape 
drives). 

There are no modifier fields for the rename, reprotect, close, 

delete, checkpoint, and fetch attributes functions. 

These functions and modifier fields are specified through 

different function code bit settings shown in Figure 7-2. The 


functions specified in the function code are executed from left 
to right. 
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Command byte Modifier byte 


ee ee eed 


rPAiATC;_RERIE_E_C TDC YI ‘Access | File 
ibis |}; Hi NiP}| Lj Lf] K {privileges |method | types 
Bits: 

0 1 2 3 4 5 6 7 8 10 11 12 13 L5 


Figure 7-2 SVC 7 Function Code Field 


The function of each bit setting in the SVC 7 function code field 
is explained in Table 7-1. 


TABLE 7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS 


Ne dd ee ee ee 


BIT H DATA H 
POSITION {| FUNCTION {| DEVICE/FILE i COMMUNICATION {| BIT SETTING 


SSSSVSSSSFETARARTELLBEELERSEDVP AAS ESS SESFSBAEVESBEEVSSSSEFOOVSS SO SFESSESSsSSssa Terese e&eSS TS SSS TS = 


O (AL) | Allocate {| Reserves space {| Reserves a i O=no function 

H i on a direct i Line control | requested 

H } access device | block (LCB) | l=reserve 

H \ i for a buffered} space 

| | {| terminal man- | 

i i ; ager i 
i l (AS) i} Assign i Assigns an lu | Assigns an {| O=no function | 
H H i to a device } lu to line i requested H 
H H } or file i driver (SVC {} l=assign an | 
H H H ; 15) and H lu H 
i { terminal 
H | H i managers H | 
H | H i} (sve 1) H i 
Ib ns es ems eae as cast es aca cca i vi an es nm Vern enya “ena ns can) tl sas, ame “cn cs ic Sm amuses Sac ea ecco ee ace ae acc ci oe Came nm “at cls } 
i 2 (CH) i Change {| Changes the | Changes the | O=no function | 
i ; access } user's current | communica- H requested H 
' } privi- {| access privi- | tions user |} l=change H 
{ | lege | lege to a new ; current { access H 
H H | access privi- | access privi- {| privilege | 
H i i lege | lege to a new | H 
H H | } access privi- j; H 
| lege 
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TABLE 7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS (Continued) 


BIT 
POSITION { FUNCTION 


3 (RN) { Rename 
7 
| 
i 
| 
| 4 (RP) {| Repro- 
i {| tect 
{ H 
i 
i | 
1 i 
1 { 
i 
i | 
i | 
i i 
{ 
i 5 (CL) i Close 
H i 
i i 
i 
i H 
{ i 
! 6 (DL) | Delete 
: ! 
H | 
H 
! 
7 (CK) Check- 
point 
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DEVICE/F ILE 


Changes the 
current file- 
name to a new 
user-specified 
filename 


Changes the 
files current 
read/write 
protection keys 
to new protec- 
tion keys 


Closes an lu 
assignment for 
a particular 
device or file 


Releases re- 
served space 
on a direct 
access device 


Copies buffered 
file data toa 
direct access 
device 


DATA { 
COMMUNICATION j; 


Changes the 1 
name of the { 
communications } 
line (SVC 15) } 
or terminal H 
(SVC 1) 


Changes the H 
read/write | 
protection H 
keys of the H 
commun i- | 
cations line |} 
(SVC 15) or { 
terminal H 
(SVC 1) to H 
new protec- H 
tion keys H 


Closes an lu } 
assignment for} 
a particular jj} 
line driver H 
or terminal H 
manager | 


Releases a H 
reserved line | 
control H 
block i 
‘] 
' 


Copies buff-  } 
ered file H 
data toa | 
logical H 
terminal i 


BIT SETTING 


O=no function 


requested 
1=change 
filename 


O=no function 


requested 
l=change 


protection 


keys 


O=no function 


requested 


l=close an lu 


O=no function 


requested 
l=release 
reserved 


O=no function 


requested 
l=copy 

buffered 

file data 


TABLE 


me emmy em meee ce sce cer mem cee esc cee em wee cee ee eee creme ce eee ee ee ce ne me ee wee ee ee ee ee re ee ee ee 


7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS 


} 

H 

H BIT 

{ POSITION |} FUNCTION 
‘] 

(] 

; 8 | Access 
! 9 i privi- 
; 10 | leges 
| 

' i] 

t { 

i H 

H { 

i ! 

t fT 

H H 

H { 

H i 

H 

i EE | Access 
i 12 i method 
H i 

H i 

i H 

i | 

H H 

H H 

H H 

H H 

H H 

i H 

4 ‘] 

( 1 

H H 

{ 

7-8 


DEVICE/F ILE 


Specifies a 

a file's read- 
ing and writing 
restrictions 


Specifies VFC 
for devices 
that support 
VFC 


DATA 
COMMUN I CATION 


Specifies the 
terminal's 
reading and 
writing 
restrictions 


Indicates 

file access 
method for 
data 
communications 


(Cont inued ) 


BIT SETTING 


000=shared 
read only 
(SRO) 
001l=exclusive 
read only 
(ERO) 
010=shared 
write only 
(SWO) 
Oll=exclusive 
write only 
(EWO ) 
100=shared 
read/write 
(SRW) 
101=shared 
read, 
exclusive 
write 
(SREW) 
110=exclusive 
read, 
shared 
write 
(ERSW) 
lll=exclusive 
read/write 
(ERW) 


00=terminal 
level 
(SVC 1) 
access 
Ol=terminal 
level 
(SVC 1) 
access 
with ver- 
tical forms 
control 
10=reserved 
ll=line level 
(Svc 15) 
access 
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TABLE 7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS (Cont inued) 


BIT | DATA 
POSITION |} FUNCTION | DEVICE/FILE | COMMUNICATION | BIT SETTING 
13 File Indicates | Indicates if | 000=contiguous 
14 types or file type or buffered | files or 
15 software magnetic tape terminal or H enable 
density density being line access H manual 
selec- used is being used | density 
tion H selection 
| on Telex 
{ magnetic 
H tape 
H drives. 
H No action 
{ on other 
1 magnetic 
H tape 
| drives 
| 001=extendable 
| contiguous 
H files 
} 010=indexed 
H files 
i 011=nonbuffer- 
H ed indexed 
H files 
i 100=select 800 
BPI NRZI 
H density 
{ (STC and 
| Telex 
H drives 
H only) 
{| 101=Select 
H 1600 BPI 
| PE density 
| (STC and 
i Telex 
| drives 
only) 


! 
{ 
| | 
! | 
( { 
! i] 
4 ' 
| 
! 
| 
! ! 
1 1 
! ! 
i i) 
| 
! ! 
t ' 
| ] 
| 
| 
{ ! 
‘ | 
| | 
| | 
| 
| 
! ! 
' ' 
| 
| 
| 
| 
| 
| 
| 
| 
| | 
| | 
| 
| 
| 
| 
| | 
| 
| 
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TABLE 7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS 


— ee ee a et ee ee cee mee ee me mn eee eee cee cee ee nme ee ee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee 


BIT 
POSITION 


13 
14 
15 


(Contin- 
ued ) 


an ae eS Sa SD a De Se ee cy OR em Se ce eee ee Se ne ee ee ee ee ee wee ee ee me cy eG OD ee ae ee ee ee ne ee 


X'0000'=fetch 


A ea ee NN ed 


X'FF20'= VFC 


ees ae ee ee ee a ee ee ee eee ee a ee ee ee ee ee ee ee ce ee ee ee ee ee ee eee ee ee ce ee ee ee ee ee eee ee ee ee ey ee ee ee ee oe oe 


X'FFOO= re- 


FUNCTION 


Vertical 
forms 
control 
(VFC) 


Fetch 
time and 
date 
attri- 
butes 
from 
disk di- 
rectory 


DEVICE/FILE 


DATA 
COMMUN I CATION 


Returns the physical attri- 
butes of a file or device to 
the parameter block. 


Turns VFC on or off for de- 
vices that support VFC. 


Returns time and date disk 
file was created and last 


written to. 


(Cont inued) 


BIT SETTING 


110=select 


6250 BPI 


GCR density 


(STC and 
Telex 
drives 
only) 


111=comnuni- 


cations 
buffered 
terminal 


attributes 


on 


X'FF21'= VFC 


off 


turns time 
and date 
in sysgen 
format 


X'FFOL]'= re- 


turns time 
and date 
in 
mm/dd/yy ; 
hr:min:sec 
format 


X'FFO2'= re- 


turns time 
and date 
in 
dd/mm/yy ; 
hr:min:sec 
format 


mee eee ee eee ee eee ee ee ee ee eee ee ee ee we Owe we oe 
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TABLE 7-1 SVC 7 FUNCTION CODE BIT DEFINITIONS (Continued) 


i MEAN ING H 

H pe Se sSrene Saar ns SSeseesSseSaes- | 

' BIT \ H | DATA { 

{ POSITION {| FUNCTION {| DEVICE/FILE | COMMUNICATION {| BIT SETTING 

i EERE ETSSESEETRTSSEFEETSCEABAECSRVESECETSASECATCCBEETISESESEBEAETBSESEEEEECRVAVIVSsBsVeeae_Vescwwes 
; O-15 { H | X'FFO3'= re- 

{| (Contin- | { | turns time 
{ ued) H H i and date 

H in Julian 
i format 

{ | | { X'FFO4'= re- 

| turns time 
H | | H and date 

H | i | in direc- 
{ i i { tory for- 
mat 

| -- eee nn 
+ O-15 {| Fetch } Returns current total logical | X'FFOA' 

{ | logical | records, current logical { 

H {} attri- {| record position, index H 

H | butes | blocksize, and data { 

H | of open | blocksize | 

| file | 


7.2.1.1 Allocate Function 

The allocate function makes a directory entry and reserves’ space 
on a direct access device for the file type specified in the 
modifier byte. The required parameter block fields for this 
function are: 

e Bits 0, and 13 through 15 of the function code 

e Write key field 

@e Read key field 

@e Logical record length field 

@e Volume name field 

@e Filename field 

@® Extension field 

e File class field 


e File size field 
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When a contiguous file is allocated, the file sectors are 
reserved; and the filename, sector starting address, read/write 
keys, file type, and dates created and written are entered into 
the directory. A contiguous file is not buffered. When an 
indexed file is allocated, the filename, number of logical 
records, read/write keys, file type, and dates created and 
written are entered into the directory. 


When an extendable contiguous file or nonbuffered indexed file is 
allocated, the file directory is set up as for an indexed file. 


When doing an allocation using a data communications terminal 
manager, two data buffers, each equal to the device physical 
block size, are reserved in memory for the line control block 
(LCB). The buffered terminal filename, logical record length, 
and read/write keys are entered into the LCB. See the 0OS/32 
Basic Data Communications Reference Manual. 

7.2.1.2 Assign Function 

The assign function uses an lu to establish a logical connection 
between the task and file or device, and the communications line 


and buffered terminal. The required fields in the parameter 
block are: 


@ Bits 1, and 8 through 12 (and 13 through 15 for magnetic tape 
drives) of the function code 

e Logical unit field 

e Write key field* 

e Read key field* 

@ Volume name field 

e Filename field* 

e Extension field* 

e File class field 


x Used for direct access devices 
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When assigning to disk devices, the user-specified read/write 
keys corresponding to the specified access privileges are 
compared to the read/write keys in the file directory entry. If 
there is a match, the file is assigned according to the specified 
access privileges. If the access privileges are SWO or EWO and 
the user executes an assign function, the file is positioned at 
its logical end (append mode); otherwise, the file is positioned 
at the beginning. The access method '0O1' specifies the use of 
vertical forms control VFC. 


When assigning to nondirect access devices, only the access 
privileges are examined. If the file is an indexed file, two 
data buffers and one indexed buffer are allocated in system space 
when the file is assigned. Each data buffer equals the file data 
block size; the index buffer equals the file index block size. 
If the file is an extendable contiguous file or nonbuffered 
indexed file, one index buffer is allocated in system space when 
the file is assigned. 


7.2.1.2.1 Temporary File Allocation and Assignment Function 


The allocation and assignment function can also reserve’ space 
temporarily on a direct access device for the file type specified 
in the modifier byte. Such a file is temporary because it exists 
only while the file is assigned to an lu and is deleted when the 
file is closed. The required parameter block fields for this 
function are: 


e Bits O, 1, 8 through 10, and 13 through 15 of the _ function 
code field 


e Logical unit field 
e Logical record length field 


e File size field 


To allocate a temporary file, specify an allocate or an assign 
function and an ampersand (&) as _ the first character of the 
filename. When the temporary file is allocated, a directory 
entry is made for the filename, and the file is placed by default 
on the temporary volume. The temporary file is then assigned to 
the lu specified in the parameter block. A temporary file also 
can be allocated and assigned from the system console through the 
TEMPFILE system command. See the OS/32 Operator Reference 
Manual. 
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7.2.1.3 Change Access Privileges Function 


The change access privileges function changes the current access 
privileges of an assigned file or device to the access privileges 
specified in the parameter block. The new access privileges must 
be compatible with the existing ones; otherwise, the existing 
access privileges of the file remain unchanged. For example, if 
the device is assigned with read only privileges, a change to 
write access privileges is not permitted. Table 7-2 illustrates 
allowable access privilege requests relative to current access 
privileges, exclusive of other assignments to the same fd. The 
required parameter block fields for this function are: 


e Bits 2, and 8 through 10 of the function code field 


e Logical unit field 


TABLE 7-2 ALLOWABLE ACCESS PRIVILEGE CHANGES 


| CHANGE TO 
| CHANGE | ------------------------------------------------- 
| FROM {| SRO | ERO | SWO | EWO | SRW | SREW | ERSW | ERW } 
i] 1 
| { 


Re ee ae 
feo tf xix toot tf ft 4 to 
| swooi of texted tb bf 
[wo i i t«ix tt i tJ 
| SRW} x i x tox tox tox toe te tx | 
| SRW} x i x | x tox foe | x tox Tx | 
| RSW} x i x i x tx |x | x tox tx | 
| ERW of x | x t x | x | x toe | x fx | 
LEGEND 


x indicates allowable change 
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7.2.1.4 Rename Function 
The rename function causes the filename and extension identifiers 
currently in effect to be changed to the filename and extension 
identifiers specified in the parameter block. The file must be 
currently assigned to the specified lu with ERW access privileges 
and exist on a direct access storage device. The required 
parameter block fields for this function are: 
e Bits 3, and 8 through 10 of the function code field 
e Logical unit field 
e Filename field 
e Extension field 
e File class/account field 
When executing the rename function, the parameter block volume 
name is ignored, and the specified filename and extension replace 
the current filename and extension in the device directory. 
NOTE 

An e-task is allowed to rename a device. 

See the OS/32 System Level Programmer 

Reference Manual for more information. 
7.2.1.5 Reprotect Function 
The reprotect function changes the read/write protection keys of 
a currently . assigned file to the contents of the read and write 
key fields. The file must be on a direct access device and 
assigned to the specified lu with access’ privileges. The 
required parameter block fields are: 
e Bits 4, and 8 through 10 of the function code field 
e Logical unit field 
e Write key field 


@ Read key field 
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When executing the reprotect function, the specified read/write 
keys replace the current read/write keys of a specified file in 
the device directory. 
NOTE 

An e-task is allowed to reprotect a 

device. See the OS/32 System Level 

Programmer Reference Manual for more 

information. 
7.2.1.6 Close Function 
The close function breaks the logical connection between the task 
and file or between the device or a data communication line and 
terminal by closing the currently assigned lu. The parameter 
block's required fields are: 
e Bit 5 of the function code field 
e Logical unit field 
When the lu is closed, all data in file buffers or terminal 
buffers are copied to the user file. 
7.2.1.7 Delete Function 
The delete function removes the file directory entry and releases 
the reserved space of a currently unassigned file on a direct 
access device. When deleting through the communications buffered 
terminal manager, a currently unassigned LCB is removed from 
memory. The required parameter block fields are: 
e Bit 6 of the function code field 
e Write key field 
@e Read key field 
@ Volume name field 
e Filename field 


e Extension field 


e File class/account field 
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If the contents of the parameter block volume name, filename, 
extension, and read/write keys fields match the fields in the 
file directory entry, the file is deleted. If the logical 
terminal name matches the name in the LCB, the LCB is deleted. 


7.2.1.8 Checkpoint Function 


The checkpoint function copies the buffered file data to the 
indexed file or the buffered terminal data to the terminal and 
updates the directory entries. Executing a checkpoint function 
on a nonbuffered indexed file or extendable contiguous file 
updates the directory entries for the file. Executing a 
checkpoint function on a contiguous, nondirect access device or 
unbuffered file has the same effect as an SVC 1 wait only call. 
The required parameter block fields for this function are: 


e Bit 7 of the function code field (bits 11 and 12 for data 
communications) 


e Logical unit field 


After executing a checkpoint function, the file pointer is not 
repositioned to the beginning of the file as in a close function. 
If a system failure occurs and data exists in the file buffers, 
all data up to the last close or checkpoint function is 
recoverable; any data appended after the last close or checkpoint 


function is lost. Therefore, to prevent loss of data, use the. 


checkpoint function frequently, especially after a large amount 
of data and/or important data has been written to a buffered 
file. 


7.2.1.9 Fetch Attributes Function 


The fetch attributes function sends to the SVC 7 parameter block 
the physical attributes of the file or device currently assigned 
to the specified lu. These attributes include the device 
mnemonic or volume name, filename, extension, file class, and 
file size which are sent to their respective fields in the SVC 7 
parameter block. Device codes are sent to the modifier byte of 
the function code field. Device attributes are stored in the 
write and read key fields. The logical record length field can 
receive either a file logical record length or a device physical 
record length. These field differences for the fetch attributes 
function are illustrated in Figure 7-3. 
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10(0) i1(1) 12(2) i3(3) 
i; Command byte | Device codes | Error status | lu { 
H 

eas coy ted et te ! 
14(4) 16(6) 
Device attributes H Physical record length H 
IC ata i nT eaten int nan RRO 
i8(8) 
H Volume name or device mnemonic H 
ep ean poco ns eae eae eee 
112(C) 
pao ee ee PAiLOnNamMe 0 See 
{16(10) 
i 
ber anes ena eae eae tS Se ae eee 
{20(14) {23(17) { 
{ Extension i File class | 
i ] ' 
ee Ra OEY Dee RAP PET eee ee SO PLE EN ee ae ate cree a ee P 
t { 
124(18) 
{ File size H 
| 

Svc 7,parblk 

ALIGN 4 

parblk DB 0,0 
. DS 1 
DB lu 
DS 24 bytes for device attributes 


Figure 7-3 SVC 7 Parameter Block Format and Coding 
for a Fetch Attributes Function 


When executing this function, the device codes field receives a 
hexadecimal number indicating the file or device type. The 0S/32 
System Generation (Sysgen/32) Reference Manual lists all the 
devices and their device codes. The command byte, error status, 
and lu fields are the same as those defined in Section 7.2. 


The device attributes field receives a hexadecimal number 


indicating certain file or device attributes. Table 7-3 lists 
all supported attributes and corresponding masks. 


7-18 48-038 FOO RO1 


TABLE 7-3 DESCRIPTION AND MASK VALUES OF THE DEVICE 
ATTRIBUTES FIELD 


retiree ti antici ie A Me A A ee ee ee et 


BIT 
fa a a a Pe ae et ees ER 
! 0 | X'8000' Interactive device | 
! 1 | X'4000' | Supports read* | 
| 2 ! X'2000' ! Supports write* | 
| 3 ! X'1000' ! Supports binary | 
| 4 ! X'0800' ! Supports wait 1/0 ! 
| 5 | X'0400' | Supports random access ! 
| 6 ! X'0200' ! Supports unconditional proceed | 
! 7 X'O100' ! Supports image mode and 
extended options 
| 8 | X'0080' | Supports halt I/0 
| 9 | X'0040' | Supports rewind ! 
! 10 | X'0020' | Supports backspace record 
| 11 | x'0010' | Supports forwardspace record : 
! 12 | x'0d008! | Supports write filemark ! 
| 13 ! X'0004' | Supports forwardspace filemark 
! 14 | X'OO002' ! Supports backspace filemark | 
15 X'0001' ! Device dependent function | 


De et te en ee 


* Indicates the current access privilege. 


The physical record length field receives the logical record 
length of the file or physical record length of the device 
assigned to the specified lu; e.g., 80-byte record for card 


readers and 120- or 132-byte record for line printers. If the 
device has variable length records, a value of 0 is returned to 
this field; e.g., magnetic tape. However, variable length record 


devices are normally used as fixed record length devices. 
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For direct access devices, contiguous and extendable contiguous 
files may be treated as having either a sector-length record size 
(256 bytes) or a variable length record. Indexed and nonbuffered 
indexed files have a fixed record length which is the file's 
logical record length established at allocation time. 


The direct access device volume name, filename, extension, and 
file class are sent to their corresponding fields in the 
parameter block. For a nondirect access device, the device 
mnemonic is sent to the volume name field and the filename, 
extension, and file class fields of the parameter block are 
filled with blanks. 


For direct access devices, the file size field receives’ an 
unsigned hexadecimal number indicating the current size of a 
direct access file. For indexed and nonbuffered indexed files, 
this field contains the number of logical records in the file. 
For contiguous or extendable contiguous files, this field 
contains the number of sectors in the file. | 


For bare disk devices, the first two bytes of the file size field 
contain the controller device address if the bare disk is 
attached to a controller. If the bare disk is not attached to a 
controller, the first two bytes equal zero. The remaining two 
bytes of this field contain the SELCH device address if the disk 
is accessed via a SELCH device; otherwise; this 2-byte field 
contains a zero. 


124(18) | 
H Controller Device } SELCH Device 
} Address ' Address 


After executing a fetch attributes call, the file size field 
receives the current size of a file on a direct access device. 
The file size field is not used for nondirect access devices. 


7.2.1.10 Vertical Forms Control (VFC) 
The VFC option turns the VFC function on or off for a_ particular 


device. To execute this function, only the first four bytes of 
the SVC 7 parameter block are required as shown in Figure 7-4. 


7-20 48-038 FOO ROL 


1(1) 2(2) 
Modifier Error status 
byte 


Qmas 
: 
wy 
> 
Q, 
oy 
“< 
cr 
@ 
- 
S 


SVC 7,parblk 


parblk ALIGN 4 


DB X'FF' 

DB X'20' or ‘21! 
DS lL 

DB lu 


Figure 7-4 SVC 7 Parameter Block Format and Coding 
for VFC Function 


This parameter block must be _ fullword-boundary aligned and 
located in a task writable segment. 


To turn on the use of the VFC function for a particular device, 
set the modifier byte to X'20'. To turn the function off, set 
the modifier byte to X'21'. The error status and lu fields are 
the same as for all SVC 7 services. 


7.2.1.11 Fetch Time and Date Attributes from Disk Directory 
The fetch time and date attributes function returns to the SVC 7 


parameter block the date and time the disk file was created and 
last written to. 


FUNCTION 
CODE FORMAT 
X'FFOO' Defined by sysgen 
X'FFOL' | Month/day/year 
hours:minutes: seconds 
X'FFO2' Day/month/year 
hours :minutes: seconds 
X'FFO3' Julian 
X'FFO4' Directory 


The parameter block fields for receiving the first three options 
are shown in Figure 7-5. Sysgen can define either format 
designated by function code X'FFOL' or X'FFO2'. 
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10(0) 11(1) |2(2) 13(3) | 
{ Command byte {| Modifier byte | Error status | lu i 
' ! ! } i 
I le aa et ek eerie eee 7 
14(4) 
| 
| 
Lae Sass SeSee Created date 0 trent ren i 
{8(8) 
| | 
| | 
| manne nee ren nnn nn nnn nnn nnn nnn mannan enn anan 
1 12(C) 
| | 
(oSSerereaea= Created time 0 wrt rear r tt i 
{16(10) 
aes sa cae aie oe Be ae ee aoa a | 
120(14) 
| 
[Aaeoens reas Last written date “ag asia oo eat ret | 
|24(18) | 
| 
| 
Be ce i Shh Ss ms ‘nl su is) smi Met eam tas "Vn se Sem la shun il i'r in’ tin a nh “ep Yet sms “Sa a md! SG anit ‘Rn § 
{ { 
128(1C) H 
i 
[See esas Last written time 9 w-een-------- H 
132(20) 
| 

SVC 7,parblk 

parblk DB X'FF' 

DB X'On' n=0,1, or 2 

DS 1 

DB lu 

DS 8 bytes for created date 

DS 8 bytes for created time 

DS 8 bytes for last written date 

DS 8 bytes for last written time 


Figure 7-5 SVC 7 X'FFOO', X'FFO1', or X'FFO2' Parameter 
Block Format and Coding for Fetch Time and 
Date Attributes Function 
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The SVC 7 parameter block fields for receiving the Julian format 
are shown in Figure 7-6. The date is represented by a five-digit 
number. The first two digits indicate the year; the last three 
digits indicate the number of days since January 1. The time is 
the number of minutes since midnight. Both the date and time are 
returned as binary numbers. 


eB ate I eee een ee ee ee 


i0(0) i1(1) 13(3) 
| Command byte ; Modifier byte | Error status |} lu 
' 1 ] | 
Fa aes eS | 
14(4) 
1 Created date H 
' 1 
a he ee ee | 
18(8) 
! Created time 
i ! 
a ene eee nee En a eee ee , 
i 12(C) 
H Last written date H 
i J 
I em ae ane ete teehee ee ee | 
{16(10 


my 
SY) 
Q 
cr 
= 
rn 
-- 
ctr 
cr 
@ 
e 
ctr 
-- 
| 
® 


— uy a ee ee mee em ce ee eee eee ee ee ee ee ee a ee me i ee ee oa ee ee 


parblk DB X'FF' 


DB X'0O3' 

DS 1 

DB lu 

DS 4 bytes for created date 

DS 4 bytes for created time 

DS 4 bytes for last written date 
DS 4 bytes for last written time 


Figure 7-6 SVC 7 X'FFO3' Parameter Block Format 
and Coding for Fetch Time and Date 
Attributes Function 


The SVC 7 parameter block fields for receiving the dates and 
times exactly as they appear in the directory are shown in Figure 
o aed 
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0(0) }1(1) |2(2) 13(3) | 
Command byte {| Modifier byte | Error status | lu 
1} i ' 
Sa ah pe ee ! 
4(4) 
Created date and time H 
Ds ee a : 
8(8) | 
Last written date and time { 
' 
{ 
SVC 7,parblk 
parblk DB X'FF' 
DB X'O4' 
DS 1 
DB lu . 
DS 4 bytes for created date and time 
DS 4 bytes for last written date and time 


Figure 7-7 SVC 7 X'FFO4' Parameter Block Format 
and Coding for Fetch Time and Date 
Attributes Function 


7.2.1.12 Fetch Logical Attributes of Open File 


The fetch logical attributes of open file function returns’ the 
following attributes for an open file to the SVC 7 parameter 
block: 


total logical records currently in the file, 


current logical record position if the file is accessed 
sequentially, 


index blocksize of indexed, nonbuf fered indexed, and 
extendable contiguous open files, and 


Gata blocksize of indexed, nonbuffered indexed, and extendable 
contiguous open files. 
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The function code for this SVC 7 is X'FFOA. Figure 7-8 shows the 


SVC 7 parameter block fields for 


of an open file. 


receiving the logical attributes 


Ce I i eM etre ch a Be Ae ce teed 


Index Blocksize 


K <i 
0 
Qs 
-- 
rh 
-- 
tO) 
R 
o 
“< 
ct 
® 


bh—~ 
ry 
rs 
‘e) 
rR 
o 
ct 
oy 
ct 
Ss 
a 
tC" 
G 


Cee ene i i i Be a nc Re ee eRe tee ieee tne ce Rone Dne ele need 


ON ST NS OE AD SH SOU SD ee PY GSU EGS GE GD ORK GED ete AD tee 8D OD ES A eS AR mS TE OD EE ER SE OS meee ue me wate rue 


Se OO RSLS OD OEE FOYE heres Se menue AOS GOURD GRRE AAS ey YUN RE Ne ne eM OR SE NS SOU ME EE LS SD me eee Ee EO OO SE ee ee a el a 


10(0) 
{| Command byte 
] 
, 
14(4) 
H 
H 
H 
18(8) 
| 
H 
1 
1 12(C) 
Svc 
parblk DB 
DB 
DS 
DB 
DS 
DS 
DS 
DS 
Figure 7-8 
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7,parblk 


X'FF' 
X'OA' 

1 

lu 

4 bytes 
4 bytes 
2 bytes 
2. bytes 


for 
for 
for 
for 


total records 

current logical record 
index blocksize 

data blocksize 


SVC 7 X'FFOA' Parameter Block Format and 
Coding for the Fetch Logical Attributes 
of Open File Function 


7.2.1.13 Access Privileges 


This 3-bit modifier field contains the access privileges 
indicating the file's current reading and writing restrictions 
and is required for these functions: 


@ Assign 
6 Change access privilege 
6 Rename 


e Reprotect 


Access privileges allow other tasks to access an assigned file or 
prevent such access. Table 7-4 lists access privileges and their 
meanings that are established when the file is assigned and 
subsequently changed through the change access privilege 
function. The rename and reprotect functions require the file to 
have an assigned ERW access privilege before executing. 


TABLE 7-4 ACCESS PRIVILEGES DEFINITIONS 


ACCESS BIT 
H PRIVILEGE SETTING 


H SSS SS SSS SS SS VS ST EZ 


Shared read 


MEAN ING 


H 
t 
1 
This task can read from the } 000=SRO 
‘] 
! 
H 
i 
i 


! 1 
i | 
only (SWO) {| assigned file but cannot read | 
{ from it. Other tasks can read | 
i from and write to the assigned | 


file. 


t 
{ 
! only (SRO) assigned file but cannot write 
H to it. Other tasks can read 
{ from and write to the assigned 
file. 
mae erecehiee as as Warsi Gus Mae SRE seeeees 
i Exclusive read !} This task can read from the }| OO1=ERO /} 
i only (ERO) i assigned file but cannot write |} H 
H } to it. Other tasks can write | H 
H i; to but cannot read from the } | 
i i} assigned file. H H 
iS Sei il i Sli ane, ‘i ic "a, ia mg: ain“ ig’ Cl mit: ag wan cn, Ge sa Vi) ‘wm sh hi gst’ =e a: a “a” Si a i ti ens in’ el‘: a "san. ‘a H 
Shared write This task can write to the 010=SwWwo i} 
! 
{ 
H 
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TABLE 7-4 ACCESS PRIVILEGES DEFINITIONS (Continued) 


al a El ee ee ne ee Ene enn nnn ee 


ACCESS BIT 
PRIVILEGE MEAN ING | SETTING | 
i Exclusive write | This task can write to the {| 011=EWO jj 
| only (EWO) | assigned file but cannot read | 
| from it. Other tasks can read | 
i from but cannot write to the | 
H { assigned file. 
oa ween cade aia waka wipeinier ees chatiemkdy a= aac taleinn- near aon a mace mT | 
i Shared read | Tasks can read from and write {| 100=SRW | 
i write (SRW) i to the assigned file. This is | 
i the default. 
(ly Sokeceg sis ania 1 Eien an oh a a ae a ee | 
i Shared read i This task can read from and ;{ 101=SKEW | 
| exclusive i; write to the assigned file. | 
i write (SREW) i Other tasks can read from but | 
; cannot write to the assigned j; 
i file. 
peaesaes Be eens ree ere Semaine eae | 
i Exclusive read ;j This task can read from and } 110=ERSW | 
| shared write } write to the assigned file. | 
i (ERSW) | Other tasks can write to but } { 
| | cannot read from the assigned | 
i file. 
ae aa a a a a a a ca 
i Exclusive read | This task can read from and {| 111=ERW | 
{| write (ERW) i write to the assigned file. | 
j Other tasks cannot read from } 
;} Or write to the assigned file. | 
7.2.1.14 Data Communications Access Methods 
This 2-bit modifier field contains the access methods used by 


data communications. 
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The access methods are listed in Table 
7-5. See the OS/32 Basic Data Communications Reference Manual. 


TABLE 7-5 DATA COMMUNICATIONS ACCESS METHODS DEFINITIONS 


Terminal level 
access 


Line level 
access 


This device independent support 
of a communications terminal 
through the data communications 
terminal manager is in both 
buffered and unbuffered mode. 
This is accomplished through 
Svc l. 


This is the device dependent 
support of a communications 
line through the data communi- 
cations driver. This is accom- 
plished through SVC 15. 


{ 00 =terminal 
' level 

H access 

' O01 =terminal 
; level 

H access 

; with 

{ vertical 
} forms 

{ control 


ll =line 


7.2.1.15 File Types 


This 3-bit modifier field contains file types used 
by the allocate function. The file types are: 


e Contiguous files 


@e Extendable contiguous files 


e Indexed files 


e Nonbuffered indexed files 


e Data communications buffered terminal manager 


and required 
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. DATA 
COMMUNICATIONS | 
ACCESS METHOD | MEAN ING . i BIT SETTING 


The file type field is also used to select the density of write 
operations to a magnetic tape drive. This selection is made 
when the magnetic tape driver is assigned to an lu through the 
svc 7 assign function. The software density selections 
available to the assign function are described below. 


serrine DENSITY SELECTION 
000 Manual density (Telex drives only) 
100 800 BPI NRZI density (STC and Telex drives only) 
101 1600 BPI PE density (STC and Telex drives only) 
110 6250 BPI GCR density (STC and Telex drives only) 


For STC and Telex drives neither software density selection nor 
manual density selection has any effect on read operations. The 
tape is always read at the density at which it was recorded. 


For drives that require software enabling of manual density 
selection (i.e., Telex drives), a value of zero should be placed 
in the file type field if manual density selection is desired. 
For drives that require manual enabling of software density 
selection (i.e., STC), software select should be enabled on the 
operator panel before the first output operation is attempted. 
Otherwise, the tape will be written at the manually selected 
density. In addition, if the magnetic tape drive does not 
support software selection of density and the file type field 
does not contain zero, the drive will not be assigned and status 
code X'09' will be returned in the SVC 7 parameter block. 


7.2.1.16 Read/Write Key Fields (SVC7.RKY/SVC7.WKY) 


The read/write key fields should contain the hexadecimal number 
indicating a file or the device read/write protection keys 
established at allocation time. When atask is assigned to a 
file or device through an lu, the read/write protection keys 
specified at assign time are compared to the keys established at 
allocation time for a match. If they match, the condition is 
met, and the task can be assigned for the protected access mode 


(conditionally protected). Files and devices can be 
unprotected, allowing any key’ specified at assign time to be 
accepted. Files and devices can also be unconditionally 


protected, causing rejection of any keys specified at assign 
time. Table 7-6 lists the read/write protection keys. 


48-038 FOO ROL 7-29 — 


TABLE 7-6 READ/WRITE PROTECTION KEYS DEFINITIONS 


es as Ne ae A SN RN ee se ee ce eS ee ee ee ee ee ee ee in ee ee ome oD 


KEYS { MEAN ING 
00 | Unconditionally unprotected; the file or 


{ 
| Gevice is unprotected for the specified 
{| access mode (read or write). Any key 
| specified at assign time is accepted. If no 
i keys are specified, this key is the default. 
| Conditionally protected; the file or device 
| is protected for the specified access mode 
i (read or write). Matching keys’ must be 
| specified at assign time to gain access to 
} the device or file. 


| Unconditionally protected; the file or device 
| is protected for the specified access mode 
| (read or write). No user task (u-task) can 
| assign for protected access mode. 


7.2.1.17 File Size Field (SVC7.SIZ) 


The file size field must contain a hexadecimal number indicating 
the file size established at allocation time on a direct access 
device. For contiguous files, this field must contain the 
number of sectors in the file. 


ee ee ome meme Ae ee em ee ee ee eee ee oie ee ee ee ee em mee ee ee ee ee 


i24(18) 

i Number of sectors 
t 

t 


ce Eh et Eee 


For indexed, nonbuffered indexed, and extendable contiguous 
files, the first two bytes of the file size field must contain 
the index block size in increments of sectors (256 bytes); the 
remaining two bytes of the file size field must contain the data 
block size in increments of sectors. 


124(18) Index block size i26(1A) Data block size 
i (sectors) (sectors) 
H (SVC7.ISZ) i (SVC7.DSZ) 
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For data communications buffered terminals, this field must 
contain the physical block size in bytes. 


124(18) 

| Physical block size (bytes) 
' 

‘ 


CT ee dd dd ee 


For bare disk devices, the first two bytes of the file size 
field contain the controller device address if the bare disk is 
attached to a controller. If the bare disk is not attached to 
a controller, the first two bytes equal zero. The remaining two 
bytes of this field contain the SELCH device address if the disk 
runs from a SELCH device; otherwise, this 2-byte field contains 
a zero. 


124(18) }26( 1A) 
| Controller Device | SELCH Device 
{ Address | Address 


Ce et rt etn eel arn a he he ee i eee a ee Re ee) 


After executing a fetch attributes call, this field receives the 
current size of a file on a direct access device. This field is 
not used for nondirect access devices. 


7.2.1.18 SVC 7 Error Codes 


If an error occurs during execution of an SVC 7 function, 
execution of the current function stops, and any other functions 
to the right of the current function are not executed. The 
error code indicating the type of error is stored in the _ error 
status field of the parameter block. See Table 7-7 for the list 
of SVC 7 error codes. 
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TABLE 7-7 SVC 7 ERROR CODES 


MEAN ING 


Specified filename already exists 


on specified volume. 


Specified filename does not exist 


on specified volume. 


Insufficient space exists on 


a file of the specified size. 


! 
t 
specified volume to allocate i 
] 
{ 
§ 


ERROR | FUNCTIONS 
CODE | AFFECTED 

0 { All 

1 { All 

2 | All except 

| allocate 

3 i All except 

i rename 
4 | Allocate 
i Rename 
1 
{ 
| Assign 
5 | Allocate 
| 
t 
6 i Assign 
1 
( 

7 Allocate 
Assign 
Change 
access 


privilege 


Reprotect 


Delete 


Rename 


Read/write protection keys do 


not match. 


as ERW. 


Specified filename or device H 
cannot be assigned because H 
requested access privileges H 
' 
j 


cannot be granted. 


Current access privileges are 

not changed to new access 
privileges because the specified 
new privileges are not compatible 


Tees 


File not assigned ERW 


with existing ones. See Table { 
j 
: 


mee mee em eee ee CR ce ee me me 


a A 


File assigned to another task { 
] 
| 


(not closed). 


t 
Read/Write Protection Keys AG not | 
match. File not assigned ERW. H 
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TABLE 7-7 SVC 7 ERROR CODES (Continued) 


nell cemnell eel anal cee lisse caste ster tee el ae Rael eel eel ene eae eet ne ae et ee ee ee Rae ee eee ae ee ee eee 


| ERROR {| FUNCTIONS | H 
{ CODE {| AFFECTED { MEAN ING H 
H 8 | Assign | Insufficient space for file 
{ H } control block (FCB) and buffers H 
{ Close | System space pointer or pointers | 
ij have become corrupted. { 
{ | Delete | Task has exhausted its allocation } 
| of dynamic system space determined} 
i by Link. 
' ' ! 1 
' { t t 
{ 9 | Assign i The lu is already assigned or H 
{ H i Gevice is offline. { 
H | Magnetic tape drive does not H 
H H i support software density selecion. | 
' ! ] 
! ! Pca ea eens et enna eS ! 
| Rename | The lu is not assigned. 
{ | Reprotect |} H 
{ | Close H | 
H i Fetch i H 
H ; attributes | 
{ i Change H i 
i access 
{| privileges j; 
| | VFC | | 
ba See See es ee er ee ee ee 
{ A i Allocate { Specified volume is not a direct | 
{ ij Rename | access device. H 
a a a a a ue alas 
B { Reprotect {| The fd format is incorrect. 
| All | 
focus srl Sia er es RS Se ET es SC eee | 
C | Assign | Specified trap generating device | 
| does not exist in the system, is | 
H H i} not a connectable device, or is | 
{ H | busy and cannot be connected. 
ata a a ad 
H D {| Allocate | Allocation or deletion was 
H | Delete { attempted ona system or 
H H | group file. H 
[pete Se SERS a= Shea HSS See aS 6 eee eee aes He ee 
| E-7F {| N/A | Reserved 
Ye on rg te ody Ug gee ge Te ese Pi eng we aye eT Mg og Ee ee tee gg oe eee ae fay i 
N/A 


Svc 1 I/O error. See Tables 2-3 | 
and 2-4. 
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CHAPTER 8 
LOAD TASK STATUS WORD (TSW) SUPERVISOR CALL 9 (SVC 39) 


8.1 INTRODUCTION 

SVC 9 sets the initial TSW or replaces the current TSW located in 
the task control block (TCB) with a new user-specified TSW. The 
SVC 9 parameter block is shown in Figure 8-1. Other methods used 
for setting the TSW are: 

e The TSW is optionally specified by Link. 


e A resident task terminates by reaching end of task, which 
causes the current TSW to be replaced with zeros. 


e A task trap occurs causing a TSW swap. 


Storing TSW values into the user dedicated location (UDL) does 
not change the current TSW. 
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8.2 SVC 9: LOAD TASK STATUS WORD (TSW) 


ee ee ee eT teen eee 


iwi 1 H Queue entry H H 
ja{ Trap enable/ |Reserved/}; enable/disable i Condition | 
iij disable bits |; [6] | bits H code H 
iti [8] [13] [4] 
' 
’ 


( 
! (321 


SVC 9,A(parblk) 


ALIGN 4 
parblk DC Y'bits O through 31' 
DCF A( location counter) 


NOTE 


The decimal numbers enclosed within 
brackets [ ] in the parameter. block 
indicate the number of bits the field 
contains. 


Figure 8-1 SVC 9 Parameter Block Format and Coding 
This parameter block must be 8 bytes long and fullword-boundary 


aligned. A description of each field in the parameter. block 
follows: 


Fields: 


Wait is a l-bit field indicating whether the task 
is to enter a suspended state or is currently 
waiting for a trap. This field corresponds to 
bit 0 of the TSW. 
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Trap is a 7-bit field that must indicate, through 


enable/ its trap bit settings, whether a trap is 
disable bits to be taken when ae trap-causing condition 
occurs. This field corresponds to the trap 


enable/disable bits of the TSW. 


Reserved is a reserved 7-bit field that must’ contain 
zeros. 

Queue entry is a 13-bit field that must indicate, through 

enable/ its queue bit settings, whether an item is to 

disable bits be added to the task queue when a queue entry 
causing condition occurs. This field 


corresponds to the queue entry enable/disable 
bits of the TSW. 


Condition is a 4-bit field stored in the _ processor 

code condition code. For an explanation of the 
For an explanation of the condition code, see 
the appropriate processor user manual. This 
field corresponds to the condition code bits 
of the TSW. 

Location is a 4-byte field that must contain the 

counter address where task execution is to start or 
resume. This field corresponds to the 


location counter of the TSW. 


8.2.1 Function and Description of the Task Status Word (TSW) 

The TSW consists of two fullwords. See Figure 8-2. The first 
fullword, the status portion of the TSW, contains the: 

e trap wait bit, 

e trap enable/disable bits, 

@e reserved bits, 

@® queue entry enable/disable bits, and 


@e condition code bits. 


The second fullword of the TSW contains the location counter. 


SVC 9 allows the user to enable or disable the trap wait, trap, 
and queue entry bits in the status portion of the TSW. It also 
allows the user to set the condition code setting in the _ status 
portion and the location counter in the location counter portion 
of the TSW. See Table 8-1 for the TSW bit definitions. 
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5616-2 


BITS 0123 4 5 6 7 8 14 15 16 17 18 19 20 21 22 23 24 26 27 28 31 


BITS 32 43 44 63 


Figure 8-2 Task Status Word 


TABLE 8-1 TASK STATUS WORD BIT DEFINITIONS 


i BIT i i 
: POSITION {| BIT NAME AND MASK |} MEAN ING H 
j PSP SSS SS SS SS SSSR SS SS SSS SSS ERS SSE eS eee eee ee | 
{ O (W) i Trap wait (TSW.WTM) | Task is suspended untila | 
H + (Y¥'80000000' ) i trap occurs or until H 
H H ij cancelled. j 
(Reese ee ee a ee ee ee re ee Se SSS eae ese i 
H l (P) | Power restoration {| A trap occurs when power is} 
i i} trap enable/disable | restored after a power fail- } 
H | (TSW. PWRM) i ure. H 
1 i (Y¥'40000000' ) | H 
H i | After power is restored, all |} 
H i outstanding timer traps are _ jj} 
H } lost. Any trap wait or time | 
H } wait conditions in effect H 
H H ji are lost, and task execution |} 
H H i} continues with the instruc- } 
| tion following the one that |} 
} caused the trap. H 
H a awe is oi, a Tina at i eat ee haa ads came aaa wick ss na etn’ am eosin sod esc a “eh ena ene in a ke iia aa i ln i nn mn Gi is i | 
H 2 (A) i; Arithmetic fault | A trap occurs when an arith- } 
H i trap enable/disable | metic fault occurs. 1 
i (TSW.AFM) i 
H i (¥'20000000' ) H H 
acca eas Bee rg Tae a a, Se tm ae Sa a ree oe een renee a a a er re See i 
{ 3 (S) i svc 14 execution ; Allows execution of SVC 14. H 
| trap enable/disable |} 
H i (TSW.S14M) H H 
H i 


(¥' 10000000‘ ) 
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TABLE 


Ce en ene ee ee ee ee ee 


BIT 
POSITION 


sSSSse st SSS SS eee 


4 (Q) 


DOT eee ee nen een ne ee ee ee es 


Ce ee ee ee se es ee se ee es Se ll 


Ce eee eee Me Be een Dna atti nee Ree ee ert te ee ee ee 


A trap is taken when the task 


em ane ree ew em mes cee meee eee ee ee ene me eye ee ED SUE) RS Se ne nD Se OER ee ce me ee me ee ey SS ee ee Oe ee ee ee ee ee ee 


ne es ee dd 


8-1 TASK STATUS WORD BIT DEFINITIONS (Continued) 


BIT NAME AND MASK 
Task queue’ service 
trap enable/disable 
(TSW. TSKM) 
(Y'O8000000' ) 


Memory access fault 
trap enable/disable 
(TSW.MAFM) 
(¥'04000000' ) 


Illegal instruction 
trap enable/disable 
(TSW. LITM) 
(Y'O02000000' ) 


Data format trap 
enable (TSW.DFFM) 
(Y'01000000' ) 


CPU-override status 
(TSW. CPOM) 
(Y'O00800000'° ) 


Subtask queue entry 
enable/disable 
(TSW.SUQM) 
(Y¥'00010000' ) 


Device interrupt 
queue enable/ 
Gisable (TSW.DIQM) 
(Y'O00008000' ) 


Task call queue 
entry enable/ 
disable (TSW.TCM) 
(Y'00004000' ) 
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MEAN ING 


trap occurs when an item 


A 
is added to the task queue. 


A trap occurs’ when the task 
attempts to access memory 
outside its task boundaries. 


A trap occurs when the task 
tries to execute an illegal 
instruction. 


executes an instruction that 
causes a data format or 
alignment fault. 


Task is executed on the CPU 
and cannot be transferred to 
an APU for processng. (This 
bit applies only to tasks 
running. on the Model 
3200MPS. ) 


An item is added to the 
monitor task queue each time 
the subtask status changes. 


An item is added to the task 
queue when a trap generating 
device connected to a task 
interrupts task execution, 
or when an SVC 6 sint func- 
tion is directed to a task. 


An item is added to the task 
queue when an SVC 6 queue 
parameter function is 
directed to this’ task. 


sS SSS SSS SPSS SSeS SST SS SES SSS SS SSS 


TABLE 


8-1 TASK STATUS WORD BIT DEFINITIONS (Continued) 


ee ee ee Be Be ee ee eh een ded dee 


BIT 


POSITION 


18 (AP) 


26 (TE) 


BIT NAME AND MASK 


ZBaoBtTerteiweTwEesrT sw Tes SCS SS SS SSS SS SS ST ST ST lS KS ST ST SS SS VS SS STS STS j 


Queue entry on 
signal from APU 
(TSW, APTM) 
¥'O000 2000' 


Task message queue 
entry enable/disable 
(TSW. PMM) 
(Y¥'00001000' ) 


Load and proceed 
completion queue 
entry enable/ 
disable (TSW.LODM) 
(Y¥'O00000800' ) 


I/O completion 
entry enable/ 
disable (TSW. IOM) 
(¥'00000400') 


Time interval 
completion queue 
enable/disable 
(TSW. TMCM) 
(Y¥'O00000200' ) 


SvC 15 function 
SvC 1 buffer trans- 
fer completion 
(TSW. ITM) 
(Y'00000100' ) 


Event queue 
service enable/ 
disable (TSW.TESM) 
(Y'00000020' ) 


ae A a RE EN TE A NR OT NE SD ES ent GED SD Se SS SS DS ee Se ED ep Oe SD GN ME SE ee GY ey ER OR ee DD OS en i Ma OS 


Ce Dl el ee eee ee ee ee ee ee ee ee) 


beetle es el ee ell dl ne cee Dh ceed eee amelie ne ane eae ae he ne ee ee ee ny 


Adds a parameter to the task } 
queue when an APU signals H 
the CPU. | 
{ 
| 
{ 


An item is added to the task |} 
queue when an SVC 6 send mes-j} 
sage function is directed to |} 
a task. 

t 


An item is added to bie task | 
queue when an SVC 6 load and |} 
proceed function is executed } 
and the load is completed. H 
8 
1 
i 


An item is added to the task } 
queue when an SVC 1 I/O and ; 
proceed function is executed |} 
and the I/0 is Pomprered: 
{ 
! 


An item is added to the task |} 
queue when an SVC 2 code 23 | 
is executed and the interval |} 
has elapsed. H 

t 


i a LL SL a A A AG SED ES UE mee CY Se Wee mer epee GE Se es Se ee mee BOS See me SE ee mee ee meee ee were mee eee eee ee eee ee ee eee ee ee 


’ 
An item is added to the task |} 
queue when an SVC 15 function} 
is completed. See the OS/32 } 
Basic Data Communications H 
Reference Manual. An item is} 
added to the task queue each |} 
time the magnetic tape driver} 
adds a buffer to the OUT- 
QUEUE. 

' 

’ 


A trap occurs when an item 

is added to the system event 
queue or when at’ least one 
item exists on that queue. 
For more information on the 
event queue service enable/ 
disable, see the OS/32 System 
Level Programmer Reference 
Manual. 
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TABLE 8-1 TASK STATUS WORD BIT DEFINITIONS (Continued) 


Leeann ae ie Te en nnn ene nee i Ne Re Rn ee ee ed 


{ BIT H i i 
i POSITION {| BIT NAME AND MASK } MEAN ING H 
H -— 2 — 22 2-2 ee 2 2 2 ee ee ee 2 | 
i 27 (SD) | Queue entry on send | An item is added to the H 
| Qata call enable | Queue when an SVC 6 send H 
| ; (TSW.SDM) | message function is directed } 
H + (¥'O0000010) |} to the task. H 
H Fe i mc on ei il a, Son het, pls al ay ane es i “sa “nm a cn is ae i mcs a aman lS es Sa Sey i ae Yas nm “aoa “La si ede Fr hg es as jem a { 
} 28-31 } Condition code i The condition code following H 
H (CC) H | SVC 9 is eer from Enese bits. |} 
| I a ts a ft es ena ll saa as pi pan Sn mae sa Sa pte sav ae ees oa Saat am a YS ls ses H 
i 32-63 | Location eounter } Contains tive current iecat ton! 
H (LOC) ; (TSW. Bee? ;} counter. H 
NOTE 
See the 08/32 Application Level 
Programmer Reference Manual for a 


description of the items that can be 
added to the task queue. 


If execution of an SVC 9 loads a TSW with the trap wait bit 
enabled, the task is placed in a suspended state until one of the 
traps that are enabled in the same TSW occurs. However, if the 
task is placed in a suspended state and all other trap bits are 
disabled in the same TSW, the task remains in a suspended state 
indefinitely or until it is cancelled. 


If execution of an SVC 9 loads a TSW with one of the trap bits 
enabled and that trap occurs, the trap is handled as described in 
the OS/32 Application Level Programmer Reference Manual. 


If execution of an SVC 9 loads a TSW with one of the queue entry 
bits enabled and ae previously allocated item is placed on the 
task queue, no trap occurs unless the queue service trap bit of 
the TSW is enabled. 
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When a TSW swap occurs and the current TSW is replaced with a new 
TSW, task execution resumes with the instruction located at the 
address specified by the location counter of the new TSW. If the 
address of the new TSW is outside the task boundaries, the task 
is paused and a message is displayed. If execution of an SVC 9 
loads a TSW that has zeros in the _ location counter field, 
execution resumes with the instruction following the SVC 9. 


When SVC 9 loads a new TSW, the condition code of the new TSW 
becomes the current condition code. Any value ranging from 0 
through 15 (X'O0O' to X'OF') is legal. If the TSW being’ loaded 
was previously saved as an old TSW during a TSW swap, the 
condition code is restored. 
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CHAPTER 9 
OVERLAY LOADING SUPERVISOR CALL 10 (SVC 10) 


9.1 SUPERVISOR CALL 10 (SVC 10) 


SVC 10 is an internal call that provides for the automatic 
loading of overlays generated by Link. SVC 10 is not available 
to users. 


If an overlay load fails to occur, a message indicating the 
reason for the failure is displayed to the log device. Overlay 
load failure can result from an input/output (1/0) error or 
faulty coding that destroys the overlay control structure. For 
example, user code can be written in such a way as to destroy 
data in the overlay reference table (ORT). This table, which 
forms a part of the root segment and of each overlay area, 
contains pointers into the task overlay descriptor table (ODT) 
which contains the information needed to process the overlay. 
Without this information, SVC 10 cannot perform the _ load 
function. 


The overlay descriptor table entry (ODTE) is part of the ORT and 
represents the position in the ODT that contains processing 
information for the overlay to be loaded. Both the ORT and _ the 
ODT are OS system data structures and are defined in the system 
macro library. 

9.2 MESSAGES 

This message is displayed when a load failure occurs as a result 
of an I/O error: 


Format: 


I/O ERROR xxxx LOADING OVERLAY nnnnnnnn 
FAULT LOCATION yyyyyy (22z2z2zz) 
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Fields: 


XXXX is the I/O error status. Sse Table 9-1. 


nnonnnnnn is the name of the overlay that was. being 
processed when the error occurred. 


YYYYYY is the virtual address of the SVC that caused 
entry into the SVC 10 handler. 


ZZZZZZ is the physical address of yyyyyy.- 


This message is displayed when an overlay load failure occurs as 
a result of faulty coding within an overlay control structure: 


Format: 


OVERLAY ERROR xx NAME = nnnnnnnn 
FAULT LOCATION yyyyyy (2Zzzzz) 


Fields: 

XX is the error status. See Table 9-1 for error 
definitions. 

nnnnnnnn is the name of the overlay that was’ being 
processed when the error occurred. If it 
cannot be determined whether the error 
occurred in the root or in an overlay, NAME = 
nnnnnnnn is omitted from the message. 

YYYVYY is the virtual address of the SVC that caused 
entry into the SVC 10 handler. 

ZZZZZ2z is the physical address of yyyyyy. 


If the overlay load failure resulted from a malfunction of SVC 
10, the task is paused with the current program status word (PSW) 
pointing to the SVC 10 instruction causing the failure. 
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*10 
20 
21 


22 


23 


30 


#3 L 


Ce en ee ee ee 


TABLE 9-1 OVERLAY ERROR CODES AND MEANINGS 


MEAN ING 
- ODTE eviate Sutside the range of the ODT range. 
User space violation of overlay start address 
User space violation of overlay end address 


Highest level OVL required by this SVC was not 
found. 


OVL size is less than 10 bytes. Eight bytes for 
2 fullword ORT entry pointers plus a 2-byte 
instruction (BR) is the minimum size for an 
overlay. 


User space violation of ORT table address in ODT 
entry 


Pointers to ORT entries are unreliable. The 
address difference between these pointers must 
be O or an even multiple of 8 bytes. 


User space violation of ORT entry pointers 


-ODTE index in ORT is out of ODT range. 


* Indicates possible destruction of data. 
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CHAPTER 10 
AUXILIARY PROCESSING UNIT (APU) CONTROL 
SUPERVISOR CALL 13 (SVC 13) 


10.1 INTRODUCTION 

SVC 13 provides tasks running on the Perkin-Elmer Model 3200MPS 
System with the ability to: 

@e map APUs into the logical processor mapping table (LPMT), 

e control the processing of all APUs within the system, and 

e obtain processing status information on each APU in the 


system. 


Table 10-1 lists the SVC 13 function codes that allow the task to 
access 0S/32 system services for the Model 3200MPS 
multiprocessing system. 


TABLE 10-1 SVC 13 FUNCTION CODES 


| FUNCTION CODE  ; MEAN ING 


SVC 13 code 0 Fetch LPMT 
SVC 13 code 1 


SVC 13 code 2 


i 
' 
Fetch APU status H 
i 
’ 
Execute APU mapping option | 

| 

' 


SVC 13 code 3 Execute APU control option 


ee ee es 


The following sections outline the functions provided by each of 
the SVC 13 function codes. For more information on how to use 
Svc 13 in a multiprocessing environment, see the O0S/32 System 
Level Programmer Reference Manual. 
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10.2 FETCHING LOGICAL PROCESSOR MAPPING TABLE (LPMT) 

Svc 13 function code 0 can be used by all tasks in a Model 

3200MPS System to retrieve information about the APUs within the 

system. This information includes: 

e the maximum number of logical processing unit (LPUs), 

e the maximum number of APUs, and 

e the LPMT. 

The LPMT contains one entry for each LPU. This entry specifies 

the APU to which the LPU is mapped. 

10.3 FETCHING AUXILIARY PROCESSING UNIT (APU) STATUS INFORMATION 

Svc 13 function code 1 can be used by all tasks in a Model 

3200MPS System to retrieve information about the status of a 

specified APU within the system. This informaion includes: 

e the number of LPUs mapped to the specified APU, 

e the number of tasks in the ready queue of the specified APU, 

e the status of the specified APU, and 

e the names of the tasks associated with the specified APU. 
These tasks include the task actively executing on the APU, 
the task with control rights over the APU, the task with 
mapping rights over the APU, and all the tasks waiting in the 
APU's ready queue. 

10.4 AUXILIARY PROCESSING UNIT (APU) MAPPING FUNCTIONS 

Using SVC 2 code 2, a task linked with the auxiliary processing 

unit mapping privileges (APM) option can request mapping 

privileges for a specified APU in the system. These privileges 

allow a task to: 

@e mark the APU on, 

@e map the APU into the LPMT, 


@® remove all references to the APU from the LPMT, and 


@ mark the APU of€. 
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10.5 AUXILIARY PROCESSING UNIT (APU) CONTROL FUNCTIONS 

Using SVC 13 code 3, a task Linked with the auxiliary processing 
unit control privileges (APC) option can request control 
privileges over a specified APU. These privileges allow a_ task 
to: 

® initialize an APU that is waiting for power-up link check, 

e stop APU execution, 


e start normal execution (if stopped), and 


@® preempt the currently active task on an APU. 
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CHAPTER 11 
USER SUPERVISOR CALL 14 (SVC 14) 


ll.1 SUPERVISOR CALL 14 (SVC 14) 


SVC 14 gives a user-written task a means of accepting an SVC from 
a part of itself; e.g., a subroutine or other module. 


Format: 
SVC 14,A(X2) or RX1,RX2 FORMATS 
svc 14,A(FX2,SX2) RX3 FORMAT 


The address field of SVC 14 is not interpreted by OS/32 but can 
be defined by the task. Normally, it might be used to point to 
a parameter block. 


If the user SVC trap enable bit in the current task status word 
(TSW) is enabled, SVC 14 is enabled; otherwise, SVC 14 is 
considered an illegal SVC. 


When SVC 14 is executed, the operating system. stores the 
effective program address of the SVC 14 second argument into the 
SVC 14 address pointer location in the task user dedicated 
location (UDL). A TSW swap then occurs, using the SVC 14 TSW 
swap area in the UDL. The interpretation of this SVC is then 
left to the user. The effective program address is calculated as 
for an RX1l, RX2, or RX3 instruction. This facility permits the 
user to build a virtual executive task (e-task) within a_ single 
task environment. 


OS/32 AIDS, the OS/32 debugging utility, makes use of SVC 14; 
consequently, a task should not use SVC 14 while the OS/32 AIDS 
software is in operation. 


See the OS/32 Application Level Programmer Reference Manual for 
more information on enabling and handling SVC 14 task traps. 
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CHAPTER 12 
DATA COMMUNICATIONS DEVICE DEPENDENT INPUT/OUTPUT (1/0) 
SUPERVISOR CALL 15 (SVC 15) 


12.1 SUPERVISOR CALL 15 (SVC 15) 


SVC 15 allows a user-written task to access data communications 
devices at the device dependent level. See the OS/32 Basic Data 
Communications Reference Manual for more information. 
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A 


ABL instruction 
Access method 
Access privileges 


Account privileges 
Accounting information 
Accounting transaction file 
Address error 

Alignment error 

Allocate function 


APU. See auxiliary 
processing unit. 
Arithmetic fault 
fixed point division by 0 
fixed point quotient 
overflow 
floating point division 
by 0 
floating point overflow 
and underflow 
Arithmetic fault field 
Arithmetic fault interrupt 
bit 
ASSIGN command 


Assign function 


temporary file 

allocation and assignment 
Assign LPU SFUN.LPU 
ATF. See accounting 

transaction file. 

Auxiliary processing unit 

control 

control functions 

mapping functions 

status information 


B 


Bare disk devices 
controller device address 
SELCH device address 
Buffer-full bit 


Buffer length 

Buffer queues 
extended options field 
length 
length of last buffer 
trap-causing events, 
gapless I/0 
using 
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INDEX 


re 


horobtdoto do tououod 
WWHNH OO 
i 


1 


SNAPP WWW dwn 
i 
PONY RP RPNDO OOS 


we we wee ee ee ee ee me we me we ee oe ee we ee ee oe oe we ee we me we ee ee ee ee ewe ee ee ee we we ee we we ee ee we wm we me Oe me we wn wm we me mm mm wm Bm wm wee me ee ee we 


Buffer start/buffer end 
address 
Building a mnemonic table 


Calling task 
Change access privilege 
function 


Change priority SFUN.PM 
Checkpoint 

Checkpoint function 

Close 

Close function 

CMDILENGTH option 

Command byte 

Command function requests 


COMMUN I CATE 
Condition code settings for 
arithmetic operation 
Condition codes 
convert ASCII to binary 
expand allocation 
get storage 
interval wait 
move ASCII characters 
pack file descriptor 
release storage 
scan mnemonic table 
set status 
testing 
time of day wait 
timer management 


Conditional proceed 
Connect SFUN.OM 
Contiguous files 


CONT INUE 

CONTRACT ALLOCATION 
CONTROL 

CONVERT ASCII TO BINARY 
CONVERT BINARY TO ASCII 
CPU model numbers 

CTOP 


,;o'oduod 
wor 


ws 


rberada 
PRN OBE OP OWE 
ro 


~ 
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Data communicat.ions 
access methods 


buffered terminal manager 


buffered terminals 
device dependent I/O 
subsystem 


Data transfer requests 
conditional proceed 
I/O proceed 
queuing I/O requests 
test and set 
unconditional proceed 
wait I/O 
wait only 

DATE command 

Default task workspace 

Delay start for SVC 6 

Delete 

Delete function 

Density selections 
manual 
software 

Device attributes 

Device dependent status 

Device independent status 

Directed task 

Direction SFUN.DOM,SFUN.DSM 

DLIST xx command 


End of task 

End of task codes 

End task SFUN.ECM,SFUN.EDM 
Error codes SVC6.STA 
Executing SVC 2 code 17 
EXPAND ALLOCATION 
Extendable contiguous files 


Extended function codes 
control operations 
data transfer operations 
gapless operations 
local and remote 
communications 

Extended options 
communication dependent 
device dependent 
device independent 
field 
magnetic tape devices 
nonmagnetic tape devices 
status codes for mag 
tape use 
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7-27 
7-28 
7-31 
12-1 
2-22 
7-1 
2-1 
2-16 
2-15 
2-15 
2-9 


toi 
Or wowwwo 
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FETCH ACCOUNTING [INFORMATION 
Fetch attributes 

Fetch attributes function 
FETCH DATE 

Fetch logical attributes of 
open file 

Fetch overlay 

FETCH POINTER 

Fetch time and date 


attributes 


_ Fetching APU mapping 


functions 
Fetching logical processor 
mapping table 
File and device handling 
functions 
File handling services. 
svc 7. 
File manager 
File size field SVC7.SIZ 
File types 
cont iguous 


See 


data communications 
buffered terminal manager 
extendable contiguous 
indexed 


nonbuffered indexed 


Free buffer list queue 
Free send data message 


buffers, receiving task 
Freeze SFUN.FM 
Function code SVC6.FUN 


Function codes 

command function requests 
data transfer requests 
file handling services 
gapless mode data 
transfer 

general service functions 
intertask communications 


G 


Gapless I/O operations 
buffer queues 
device dependent status 
device independent status 
logical unit 
standard function code 
format 
Gapless mode parameter block 
format 
General service functions. 
See SVC 2. 
GET STORAGE 
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H M 
1 
Halt I/0 2-19 {| Magnetic tape 2-24 
i 2-32 
H 7-29 
I,J,K {| Magnetic tape devices 2-24 
H density selection 7-29 
I/O control blocks 2-15 {| Manual enabling of software 
2-16 | density selection 7-29 
I/O proceed 2-13 {| Message buffers 
2718 4 buffer format 6-26 
2-19 | Minimum abbreviation 3-76 
2-41 | Modifier byte 7-5 
I/O request. See SVC l. i Modifier fields 7-5 
Impure segment 3-7 | MOVE ASCII CHARACTERS 3-82 
3-8 {| Multiple buffer chain 6-27 
SS, « ct 6-29 
IN-QUEUE 2-32 {| Multiple buffer ring 6-27 
2-39 } 
2-41 | 
Indexed files 2-15: 4 N 
7-12 «| 
7-13 | Nonbuffered indexed files 712 
7-20) | 7-13 
7-28 } 7-20 
7-30 | 7-28 
Internal interrupt system 1-3 | 7-30 
INTERROGATE CLOCK 3-33 | Nonmagnetic tape devices 2-22 
Intertask communications. i Nonresident SFUN.NM 6-39 
See SVC 6. i Nonrollable SFUN.NRM 6-40 
INTERVAL WAIT 3-44 {| Nonzero error code 1-8 
IOBLOCK 2-15 {| Nonzero status code 2-17 
2-19 |; NULL: 2-19 
H 2-37 
' 
L H 
H O 
LENGTH OF LAST BUFFER 2-41 | 
LIB. See loader information i ODT. See overlay descriptor 
block. H table. 
Link address field 6-27 {| ODTE. See overlay 
6-28 | descriptor table entry. 
6-30 {; ORT. See overlay reference 
Link OPTION command 2-15: 4 table. 
2-19 {| OS/32 AIDS 11-1 
2-37 {| OS/32 debugging utility pe oe 
3-8 | OUT-QUEUE 2-32 
LOAD command 3-8 i 2-39 
Load task functions H 2-41 
extended load options i Overlay control structure 9-1 
SPUN.LXM 6-12 | Overlay descriptor table 9-1 
load task SFUN.LM 6-11 | Overlay descriptor table 
Load task status word 8-1 H entry 9-1 
Loader information block 6-11 |; Overlay loading 9-1 
Location counter 8-3 | Overlay reference table 9-1 
Log devices 3-27 H 
LOG MESSAGE 3-27r 3 
Logical processor mapping H P 
table 10-1 ' 
Logical unit 2-19 {| PACK FILE DESCRIPTOR 3-53 
2-37 {| PAUSE 3-5 
LPMT. See logical processor | PEEK 3-91 
mapping table. { Program status word 3-16 
{ Protection keys, read/write 7-29 
H PSW. See program status 
$ 
i) 


word. 
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Queue parameter SFUN.QM 
Queuing 1/0 requests 


R 


Read key 

Read/write key fields 
SVC7.RKY/SVC7 .WKY 
Read/write protection keys 
Receive logical unit SFUN.XRM 
Record lock bit 
Release SFUN.RM 

RELEASE STORAGE 

Rename 

Rename function 

Reprotect 

Reprotect function 

Rollable SFUN.RLM 

RTL. See run-time library. 
Run-time library 


instruction 


s 


Sample applications 

send data, receiving task 
send data, sending task 
send message, receiving 
task 

send message, 
task 

test and set 
unpack file descriptor 


sending 


SCAN MNEMONIC TABLE 

Send data message buffers, 
sending task 

Send data SFUN.DB 

Send logical unit SFUN.XSM 
Send message SFUN.MM 

SET ACCOUNTING INFORMATION 
SET STATUS 

Single buffer chain 

Single buffer ring 

Sint SFUN.IM 

Software enabling of manual 
density selection 

SPT. See system pointer 
table. 

Standard function code 
format, gapless mode 

Start bit positions 29, 
31 

Start function for SVC 6 

Status codes 

device dependent 


30, 


device dependent, gapless 
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Status codes (Continued) 
device dependent, 
Magnetic tape 
device independent 


device independent, 
gapless 
fetch overlay 
file handling services 
intertask communications 
overlay loading 
supervisor calls 
STC drives 
Structure macro 
Suspend SFUN.SM 
SVC 
error messages 
errors 
parameter block 
status codes 
SVC 1: I/O REQUESTS 
command function requests 
data transfer 
gapless I/O operations 
parameter block, gapless 
parameter block, standard 
SVC 2: GENERAL SERVICE 
FUNCTIONS 
contract allocation 
convert ASCII to binary 
convert binary to ASCII 
expand allocation 
fetch accounting 
information 
fetch date 
fetch pointer 
get storage 


interrogate clock 
interval wait 
log message 
move ASCII characters 
pack file descriptor 
pause 
peek 
release storage 
scan mnemonic table 
set accounting 
information 
set status 
time of day wait 
timer management 
unpack file descriptor 
SVC 2 code 1: PAUSE 
SVC 2 code 2: GET STORAGE 
option xX'00' 
option X'80' 
SVC 2 code 3: RELEASE STORAGE 
SVC 2 code 4: SET STATUS 
option X'00o' 


option X'80' 


SVC 2 code 5: 
SVC 2 code 6: 
TO ASCII 
option 
option 
option 
option 


FETCH POINTER 
CONVERT BINARY 


X'OO' tn 
X'40' +n 
X'80' tn 
X'CO'+n 
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SVC 2 code 7: LOG MESSAGE 
option x'‘'00' 
option X‘'20' 
option X'‘'40' 
option X‘'60' 
option X‘'80' 
option X'AO' 
option X'CO' 
option X'E0O' 
SVC 2 code 8: INTERROGATE 
CLOCK 
option xX'00' 
option X'40' 
option x'8g0' 
option X'co' 
SVC 2 code 9: FETCH DATE 
SVC 2 code 10: TIME OF DAY 
WAIT 
SVC 2 code 11: INTERVAL WAIT 
SVC 2 code 15: CONVERT ASCII 
TO BINARY 
option X'‘'00' 


option X‘'40' 
option X'80' 
option x'co' 


SVC 2 code 16: 
DESCRIPTOR 
option X'00' 
option X'10' 
option x‘20' 
option X'‘'40' 
option xX'50' 
option X'60' 
option X'80' 
option X'CO0' 
privileged task options 
SVC 2 code 17: SCAN MNEMONIC 
TABLE 
SVC 2 code 18: MOVE ASCII 
CHARACTERS 
option X'00'+tn 


PACK FILE 


option X'80'tn 


SVC 2 code 19: 
option X'00' 
option X'O0l' 
option x'02' 
option X'03' 
option X'04' 

SVC 2 code 20: EXPAND 


PEEK 


ALLOCATION 

SVC 2 code 21: CONTRACT 
ALLOCATION 

SVC 2 code 23: TIMER 
MANAGEMENT 


option x'0d0o' 

option X'10 

option X'20 

option X'40' 

option X'80' 
SVC 2 code 24: SET 
ACCOUNTING INFORMATION 


SVC 2 code 25: FETCH 
ACCOUNTING INFORMATION 
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SVC 2 code 29: UNPACK FILE 
DESCRIPTOR 


SVC 3: END OF TASK 

SVC 5: FETCH OVERLAY 

SVC 6: INTERTASK 
COMMUN I CATIONS 


assign LPU SFUN.LPU 
change priority SFUN.PM 
connect SFUN.OM 
delay start functions 
direction 
SFUN.DOM, SFUN.DSM 
end task 
SFUN.ECM, SFUN.EDM 
error codes SVC6.STA 
freeze SFUN.FM 
function code SVC6.FUN 
load task functions 
nonresident SFUN.NM 
nonrollable SFUN.NRM 
parameter block 
queue parameter SFUN.QM 
receive logical unit 
SFUN.XRM 
release SFUN.RM 
rollable SFUN.RLM 
send data SFUN.DB 
send logical unit 
SFUN.XSM 
send message SFUN.MM 
sint SFUN.IM 
start bit positions 29, 
30, 31 
start function, 
start options, 
suspend SFUN.SM 
task resident SFUN.HM 
thaw SFUN.TM 
transfer to CPU SFUN.TC 
transfer to LPU SFUN.TL 
unconnect SFUN.UM 
wait status field 
SVC6.TST 
SVC 7: FILE HANDLING SERVICES 
access privileges 
allocate 
assign 
change access privileges 
checkpoint 
close 
data communication 
access method 
delete 
error codes 
fetch attributes 
fetch logical attributes 
fetch time and date 
attributes 
function code field 
SVC7.OPT 
_ rename 
. reprotect 
temporary 
allocation/assignment 
vertical forms control 
Svc 9: LOAD TASK STATUS WORD 


SFUN.SIM 
SFUN.SOM 


svc 10: OVERLAY. LOADING 

SVC 13: APU CONTROL 

svc 14: USER SUPERVISOR CALL 
14 

svc 15: DEVICE DEPENDENT I/O 


System macro library © 1-2 ,  UTOP cia 
System pointer table 3-91 -\ 3-38 
3-9 
: 3-10 
T : 3-11 
: 3-20 
Task control block 3-20 jj 3-21 
3-91 | 6-41 
Task resident SFUN.HM 6-16 3 6-42 
Task status word 8-1 ; 
TCB. See task control block. : 
Telex drives 7-29 V 
TEMPFILE system command 7-13 
Temporary file allocation ! Vertical forms control 7-13 
and assignment 7-13 7-20 
knee leet ae Vege vertical forms 
1 . 
TIME OF DAY WAIT 3-41 , 
TIMER MANAGEMENT 3-117 | 
Transfer to CPU SFUN.TC 6-38 , 
Transfer to LPU SFUN.TL 6-38 ! 
Trap-causing events, gapless ; W 
1/0 2-42 | 
TSW. See task status word. Wait 1/0 ee 
t 2 ~ 
H buffer start/buffer end 
H address : 2-21 
i device dependent status 2-21 
i device independent status 2-19 
' extended options 2-22 
U i logical unit 2-19 
! Wait only 27k? 
UBOT 3-20 i Wait status field SVC6.TST 6-43 
3-21 { Write key 7-3 
Unconditional proceed 2-16 | 
Unconnect SFUN.UM 6-37 | 
UNPACK FILE DESCRIPTOR 3-136 } X,Y,Z 
User Supervisor Call 14 LisaL { 
Using the buffer queue 2-41 $ xXSVC1 Link option 2-32 
wl 
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We try to make our publications easy to understand and free of errors. Our 
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